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Introduction 


The C++ programming language remains the de facto language for many game development studios 
around the world. This is true because C++ provides a convenient, low-level programming language 
that allows developers to straddle the line between high-level software engineering and low-level 
coding to the metal. This makes it the language of choice for many high-performance and real-time 
computer programming projects. 


C++ is a language in active development. Many of the examples in this book use features that were 
ratified and released in the C++11 standard. Some of the features used are not yet supported by one 
of the major compiler vendors. This active and progressive language development is a major reason 
for C++ remaining a widely used and relevant language. The fact that it's the only way to write 
portable, in-house code across all of the types of computers and processors you find today makes 
learning C++ a handy skill to have. Devices that support C++ range from mobile phones, game 
consoles, ATMs, smart watches, to even glasses! C++ programmers will never be short of work. 

| hope you find this book an invaluable resource in your journey to learning the C++ programming 
language. 


__ 


Chapter 


Beginning C++ 


The C++ programming language was designed by Bjarne Stroustrup at Bell Labs, beginning in 1979. 
The goal of the language was to provide useful features from other languages of the time, such as 
Simula, with faster runtime performance. C was chosen as the basis for this new language due to its 
execution speed, portability, and wide adoption. 


The first major extension Stroustrup added to C was class support. Classes allowed a new 
programming paradigm to be used with C: object-oriented programming (OOP). Stroustrup’s new 
language quickly became known as C with Classes, eventually changed to C++ in 1983. 


C++ has been in continual development since its inception. New features were added regularly 
throughout the 1980s and 1990s and many of these have become essential tools for game 
developers. Examples of these features that are covered in this book are virtual functions, templates, 
and the Standard Template Library. 


An ISO standard for C++ was first published in 1998. Standardizing a language gives compiler 
writers a common set of features to implement if they wish to achieve C++ compatibility. 
Standardization also benefits programmers writing code in C++ as it allows them to use a common 
set of features that they can expect to behave in the same way when using multiple compilers 

or multiple operating systems and computer architectures. There have been four C++ standards 
released to date. The original standard is known as C++98. C++98 was added to with C++03, and 
new experimental features were added to the language with C++TR1 (C++ Technical Review 1). 
The current C++ standard is C++11. 


This book focuses on the most up-to-date version of the standard. However, this presents us with 
some challenges, as not all compilers have been updated to support all of the latest features of 
C++’. It can be taken for granted that when I refer to C++ in this book | mean C++11; any topics that 
require explicit reference to older C++ standards will be clear. The Microsoft’ C++ compiler included 
with its Visual Studio integrated development environment (IDE), for example, does not include 
support for constant expressions or type aliasing. (Don’t worry if you don’t understand these terms; 
they are new C++11 features and are covered in the section relating to templates.) Notes are added 
to the text in sections where relevant features are not supported by one of the major compilers. 
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Compilers 


C++ is a compiled language; this means that the code is read by a program that converts the text 
source files created by a programmer into instructions that can be executed by a processor. Different 
settings in compilers, or different compilers, can be used to turn source files into instructions 
suitable for completely different processor architectures, such as x86 and Armv7. 


The major compilers currently in use are the following: 
Microsoft Visual C++ Compiler (MSVC) 
GNU Compiler Collection (GCC) 
Apple LLVM 
Clang 


These are the compilers that this book is most concerned with, as they are the most likely to be 
encountered by game developers. MSVC is the compiler included with the Microsoft Visual Studio 
IDE and used when writing programs for Windows and Microsoft game consoles such as the 
Xbox One. GCC is common on Linux platforms and is the default compiler used when building 
native Android applications. Apple LLVM is the C++ compiler used when building OS X and iOS 
applications. Clang is a relatively new program that acts as the front end for the LLVM compiler 
(also used in the Apple ecosystem) and is included as an optional compiler by the current Android 
Native Development Kit (NDK). 


Some of the samples included in this book might not compile on your compiler of choice if that 
compiler is incompatible with all of the latest features of C++11. Switching compilers if possible or 
updating your software to the latest versions are possible options to work with these features. 


Programming Paradigms 


Programming paradigms are closely related to high-level programming styles. C++ does not enforce 
a particular paradigm and provides flexible features to enable programmers to program in the 
following paradigms. 


Procedural Programming 


Procedural programming involves writing ordered statements in blocks known as functions 

(also known as procedures). Functions are used to encapsulate code that can be reused and to 
improve code readability. C is also a procedural language and C++ contains the entire C language 
as a subset, allowing C++ programs to be written in a fully procedural manner. Part 1 of this book 
covers the aspects of C++ necessary to write procedural programs. 


Object-Oriented Programming 


OOP is supported through the addition of classes to C++. OOP involves designing a program as 
a set of discrete objects. These objects hide their implementation and data from the calling code 
(encapsulation), which allows specific implementation details to be changed at a later time without 
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affecting other sections of the program. Inheritance and polymorphism are other important aspects 
of the C++ OOP paradigm. OOP programming is the focus of Part 2 in this book. 


Generic Programming 


Generic programming is most likely the least understood paradigm in C++ despite its widespread 
use via the Standard Template Library. Templates allow programmers to write classes that can 
operate on different types via specializations. Template metaprogramming is a powerful technique 
that confers the ability to write programs within the code that generate values and code at compile 
time. Templates and Metaprogramming are covered in Part 4 of this book. 


C++ Game Programming 


C++ has been a major language of choice for game developers since its inception. All major gaming 
platforms have supported and currently support C++ compilation. This includes Windows, Linux, 
OS X, iOS, Xbox One, PlayStation 4, Wii U, and Android. 


Part 5 of this book covers advanced C++ topics that programmers will find useful as hardware 
becomes more powerful. These include design patterns, streams, memory management, 
concurrency (multithreaded programming), and a look at how we can write code that supports 
multiple game development platforms. 


Our First C++ Program 


Let’s take a look at a simple C++ program before we get started with the details of C++. Listing 1-1 
shows a simple C++ program written in Microsoft Visual Studio Express 2012 for Windows Desktop. 


Listing 1-1. Our First C++ Program 


// Chapter1.cpp : Defines the entry point for the console application. 
// 


#include "stdafx.h" 
#include <iostream> 
#include <string> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 
{ 


cout << "What is your name?" << endl; 


string name {}; 
cin >> name; 


cout << "You said your name is: " << name << endl; 


return 0; 
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The first two lines of this source code are comments. A double forward slash indicates that all text 
following the // on the same line should be ignored by the compiler. Block comments are also 
supported and are opened with /* and closed with */. You will see several uses of both forms of 
comment throughout this book. 


There are then several lines beginning with #include. This tells the compiler to include other files into 
our program. We cover the difference between source and header files in Chapter 6. 


The next line tells the compiler that we want to use the standard namespace. Namespaces are also 
covered in Chapter 6. 


The program then begins with the _tmain function. This is the first function called by the program 
when writing Windows applications that target the console. Different operating systems have 
different entry points and you'll see these throughout this book as different examples are written to 
target different operating systems and compilers. You should be able to easily alter the samples to 
use the entry point for your system of choice. 


The cout operator writes the text following the << operator to the console window. The cin operator 
stops the program and waits for the user to enter text. We store the text entered into the name variable 
and then use it to echo back the input the user entered. 


The last line returns the value O from the function to let the operating system know that we finished 
without error. 


As you can see, this simple program asks for the user’s name and then repeats that name back to 
the user. Congratulations: You’ve written your first C++ program. 


Summary 


This chapter has given you a very brief introduction to the C++ programming language. We’ve 
looked at the basic history of the language, the current main C++ compilers, its major paradigms, 
and a simple C++ program. 


The next chapters look at how we can create some simple games using the C features of C++, 
beginning with a look at the fundamental built-in types and operators in C++. 


The examples in Chapters 2 and 3 are simple programs that will help you to understand how C++ types 
and operators behave. The examples beginning in Chapter 4 see us begin to create a text adventure 
game that we will develop to completion throughout the remainder of the book. Text adventure 
games were very popular on early computers and they are an excellent way to learn C++ for game 
development without requiring you to learn the intricacies of a platform-specific windowing system or 
graphics application programming interface (API). 


__ 


Part 


Procedural Programming 


The roots of the C++ programing language come from the C programming language. C provides the 
basis for the C++ procedural programming paradigm. 


Procedural programming involves using variables and functions to create reusable procedures that 
constitute a full program. This part of the book introduces you to the features provided in C++ that 
would allow you to write fully procedural programs. 


This part of the book begins by looking at C++’s built-in types, operators, arrays, pointers and 
references, and functions before finally looking at flow control statements and methods of structuring 
your programs. 


__ 


Chapter 


Writing a Guessing Game 
with C++ Types 


You will begin the process of learning C++ by learning about the different built-in types that the 
language supports. C++ has built-in support for integers, floating point numbers, booleans, and 
enumerators. This chapter covers all of these types. We also look at the different types of operators 
that can be used to manipulate and compare these types of values. It is useful to understand how 
C++ handles variables before we begin to create programs in the language. To start, we take a 

look at the difference between dynamically and statically typed languages, which includes how we 
declare and define variables in C++. 


Dynamic Versus Static Typed Languages 


Variables in programming languages can be handled in two different ways. Dynamically typed 
languages do not require the programmer to state explicitly which type should be used to store the 
value. Dynamically typed languages can switch the type of a variable on the fly depending on how it 
is being used. 


Statically typed languages require the programmer to tell the compiler explicitly which type to use to 
represent the data the variable will store. C++ is a statically typed language and creating variables in 
C++ is a two-step process. 


Declaring Variables 


When we are introducing a new variable into a program, we are said to be declaring the variable. 
This essentially means that we are telling the compiler that we would like to have a variable of a 
specific type and with a specific name. C++ compilers require that all variables be declared before 
they can be used in our programs. An example of a variable declaration would be: 


int numberOfObjects; 
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This declaration tells the compiler that we would like to have an integer with the name 
numberOfObjects; it does not tell the compiler what the variable contains or what it should be 
used for. 


Defining Variables 


We can define our variable once we have declared it. Defining a variable involves telling the compiler 
what its initial value should be. This is an example of a variable definition: 


numberOfObjects = 0; 


It's fairly common that we will define and declare some variables at the same time. Combining the 
declaration and definition would resemble this line: 


int numberOfObjects = 0; 


We'll be looking at the places where it is appropriate to declare names to the compiler compared to 
defining them as we move through this book. The rules for declaring and defining different variables 
and types depend on the context in which they are being used. 


Integers 


The first set of types that we will be looking at in C++ is the integer types. The previous sections 
have already shown how to declare and define an integer variable. To recap: 


int numberOfObjects = 0; 


This line of code declares and defines an integer variable. What this means to the compiler is that we 
want to create a variable that is capable of storing whole numbers. Examples of integers are —1000, 
0, 24, and 1345219. Integers can contain both positive and negative numbers. 


The type int is just one of several different types that can store integers. The others are char, short, 
and long. Table 2-1 shows the different ranges of values that can be stored in these types when 
using MSVC. 


Table 2-1. The MSVC Integral Types, with Minimum and Maximum Values 


Type Name Number of Bytes Minimum Value Maximum Value 

char 1 -128 127 

short 2 -32,768 32,767 

int 4 -2,147 ,483,648 2,147,483,647 

long 4 -2,147 ,483,648 2,147,483,647 

long long 8 -9,223,372,036,854,775,808 9,223,372,036,854,775,807 
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As you can see there are five main types of integers when using C++. It's important to select a 
variable that can accommodate all of the possible values you might wish to store. Failing to use a 
type with enough possible values results in wrapping. That means that if you had a char variable 
that currently stored 127 and you tried to add a one, the value in the variable would wrap and your 
variable would then contain -128. 


Unsigned Integers 


C++ also supports unsigned versions of the integer types shown in Table 2-1. Table 2-2 shows the 
ranges that these unsigned variable types can store. 


Table 2-2. MSVC's Unsigned Integral Type Ranges 


Type Name Number of Bytes Minimum Value Maximum Value 

unsigned char 1 0 255 

unsigned short 2 0 65,535 

unsigned int 4 0 4,294,967 ,295 

unsigned long 4 0 4,294,967 ,295 

unsigned long long 8 0 18,446, 744,073,709,551,615 


Using unsigned types extends the range of available positive integers at the expense of losing all 
negative integers. These types should be used in all cases where negative numbers will not be needed. 


Two’s Complement 


Before we move on to look at some other types of variables, it is important to understand how 

the integer values we have covered are represented by the computer. You’ve seen that unsigned 
numbers of varying numbers of bytes can store numbers ranging from 0 through to their maximum 
size. In the case of a single-byte char that maximum number is 255. 


This happens because a single byte is made up of 8 individual bits. Each bit represents the next 
power of two from the last. Table 2-3 shows how you can think of the bits in a byte. 


Table 2-3. The Bits Making Up a Single Byte: The Top Row Shows the Bit Number and the Bottom Row Shows the Value This Byte 
Represents When Using Unsigned Variables 


8 7 6 5 4 3 2 1 


128 64 32 16 8 4 2 1 
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Table 2-3 shows the bit values for an unsigned char. When we have an unsigned char variable that 
stores the value 255, all of the bits are turned on. This would be represented by 11111111 in binary. 
If we add a 1 to this number the values will wrap and we will end up back at 00000000 as the 8 bits 
cannot store a higher value. This is something that you will need to be aware of when using unsigned 
integer variables. 


When you want to represent negative numbers using signed variables, the processor will use Two’s 
Complement. Two’s Complement works by using the highest bit to represent whether the number is 
positive or negative. The highest positive number that can be stored in a char variable is 127 and is 
represented in binary by 01111111. Adding 1 to this number gives us 10000000, which is -128 and 
once again shows you how wrapping occurs in practice. 


Switching between a positive and negative number is a simple process. You have to switch all of the 
bits and add one. The number 1 is represented in binary by 00000001. To flip 1 to -1 we first flip all 
of the bits to 11111110 (which is -2) , then add 1 to give us 11111111. 


This is a brief introduction to how a processor represents the integer values your programs will store 
in memory. We will cover some more binary representations of numbers in Chapter 3 when we look 
at binary operators. 


Floating Point Numbers 


Floating point numbers in C++ are used to represent numbers with a decimal point. Examples of 
these are -10.5, 0.3337, and 89.8376. 


Like the signed integer types, floats can be used to store positive and negative numbers. Unlike 
integers, though, there are no unsigned versions of floating point numbers. Defining a floating point 
is done in the following way: 


float decimalNumber = 1.0f; 


When defining floating point variables in code, the value must be followed by an f. The reason for 
this is that a number with a decimal point but no f is a double. 


The current floating point standards require that floats be represented with 32 bits (or 4 bytes). 
Thirty-two-bit floating point numbers might not have a large enough range for what we would like 

to achieve under given circumstances, so C++ also supplies the double type. The float type can be 
thought of as a single precision floating point number and the double type is then a double precision 
floating point number. A double can be defined as follows: 


double doubleNumber = 1.0; 


Single precision floats are usually sufficient for all but a few scenarios in game development and are 
generally faster and more efficient for the types of tasks we carry out. 
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Boolean Values 


Booleans are simple values that can only contain true or false. Booleans are usually, but not always, 
implemented as a single byte char. A value of 0 is usually used to represent false and any nonzero 
value is true. We rarely use numbers to represent booleans, as C++ contains the true and false 
keywords. A couple of boolean variable declarations would be: 


bool isTrue = true; 
bool isFalse = false; 


We’ve already seen in the previous section that functions can return boolean values to help create 
statements that make sense to a human reader: 


bool numberIsNaN = isnan(nan); 


Booleans will also become useful once we start looking at flow control statements in Chapter 5. 


Enums 


C++ allows us to create an enumerated list of values. This is useful if we wish to convey sets of 
things that have readable names. An example of an enum in C++ is: 


enum class Color 
Red, 


Green, 
Blue 


}3 


This has effectively contained a new type in C++, Color. We can create new variables of type Color 
like this: 


Color currentColor = Color: :Red; 


Using enums is a useful way to create code that is highly readable. Compare the preceding line to 
this: 


unsigned int currentColor = 0; 


This code essentially does exactly the same as the preceding line, but it is much more difficult to 
understand. We have no way of knowing that 0 was the color red and it was also possible to assign 
the number 10 to currentColor, which wouldn’t be a valid color. 
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Enums also allow us to assign a value to each element. In the Color enum we currently have Red 
assigned the value 0, Green 1 and Blue 2. In the enum definition we could have used the following: 


enum class Color 


{ 
Red, 
Green = 10, 
Blue 

J 


In the preceding enum, Red is still 0, and Green is 10; however, Blue is 11, as it directly follows Green. 
There are few occasions where we need to specify the values of enums as they are most useful for 
creating more readable code; but it is useful to understand that this is possible because you will 
come across code written by others that will use this feature. 


It’s also important to note that the enum class is a C++11 construct. Prior to C++11 the enum would 
have been created using the following: 


enum Color 

{ 
Red, 
Green, 
Blue 

}; 


C++11 style enums are known as strongly typed enums. The compiler will not allow you to 
accidentally use integers in place of the enum values. It also wouldn’t have been possible to use the 
value Red in two different enums. 


enum Color 
{ 
Red, 
Green, 
Blue, 
}; 
enum TrafficLights 
{ 
Red, 
Amber, 
Green 
J; 


This is not allowed with older enums, as the code to define a variable would look like: 


Color currentColor = Red; 
TrafficLights = currentLight = Red; 


As you can see, we have no way of knowing which Red is to be used. This is even worse with the 
Green value, as it would have a different integer representation: 1 in Color and 2 in TrafficLights. 
This could cause bugs in our code as it would be valid to use the TrafficLights version of Green 
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when we really meant to use the Color version. The compiler would assume that we meant Blue as 
both Color: :Blue and TrafficLights: :Green are representations of 2. Using an enum class, however, 
means the code must look like this: 


Color currentColor = Color: :Red; 
TrafficLights = currentLight = TrafficLights: :Red; 


As you can see, the strongly typed version of enums is much better and provides us with more 
explicit code. Always use an enum class where possible in new code. 


Enums are the last type introduced in this chapter. We can now spend the rest of the chapter looking 
at the different types of operators that C++ supplies to work with our types. 


Switching from One Type to Another 


Sometimes while writing our programs we will have a value stored as one type, such as an int, 
but we would like to use the value from our variable along with a value stored in another variable. 
Fortunately C++ can automatically convert from some types to others. The following lines of code 
provide some examples: 


char charNumber = 1; 
int intNumber = charNumber; 
float floatNumber = intNumber; 


C++ can implicitly convert numbers from one type to another. Going from smaller types to larger 
types and from integer types to floats and floats to doubles as well as from integer types to bools are 
all legal and carried out automatically by the compiler. 


static_cast 


Whereas moving from a smaller type to a larger type is safe, moving from a larger type to a smaller 
type can cause a loss of data. For example: 


int largeNumber = 1000; 
char smallNumber = largeNumber; 


In this case, the large number would likely be truncated from 1,000 to 127, as that is the largest 
number that a signed char variable can hold. This type of data loss is known as a narrowing 
conversion. C++ compilers give warnings about this type of conversion and many game 
development studios like to keep their code error-free or enable compiler settings that cause all 
warnings to become errors. Fortunately C++ provides us with a method to tell the compiler that we 
were converting this value on purpose. This method is known as a static cast. An example of the 
usage of static_cast would be: 


char smallNumber = static_cast<char>(largeNumber) ; 


This code tells the compiler that we are purposefully converting our type to a char and it will not 
output any warnings for the conversion. 


14 CHAPTER 2: Writing a Guessing Game with C++ Types 


It’s also good practice to use static_cast when carrying out conversions to larger types (actually 
called widening conversions) to make it clear and obvious to other programmers that we have used 
the conversion on purpose and that it is not actually a mistake. 


static_cast is evaluated by the compiler at compile time and will cause a compilation error if we are 
trying to convert between incompatible types. 


A Simple Guessing Game 


We’ll use what you have learned about declaring and defining variables and integers to create a 
simple guessing game. In the beginning the game will be basic; however, we will add to the game 
throughout the remainder of this chapter to make the output more like a game. 


For now we will ask the player to input a number and output that number and a random number 
selected by the program. Listing 2-1 shows the program written to compile using C++ 4.7.3. 


Listing 2-1. A Simple C++ Guessing Game 


#include <ctime> 
#include <cstdlib> 
#include <iostream> 
#include <string> 


using namespace std; 


int main() 
{ 
// Generate unique random numbers using the current time 
srand(time(NULL) ); 
// Get a random number between O and 99 
unsigned int numberToGuess = rand() % 100; 


cout << "Guess a number between O and 99" << endl; 


unsigned int playersNumber {}; 
cin >> playersNumber; 
cout << "You guessed: " 

<< playersNumber 

<< " The actual number was: 
<< numberToGuess 

<< endl; 


return 0; 


} 


Our guessing game source code begins by including the C++ header files necessary for the features 
we use and declares that we will be using the std namespace. 
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#include <ctime> 
#include <cstdlib> 
#include <iostream> 
#include <string> 


using namespace std; 

The entry point for our program when using GCC is: 

int main() 

Listing 1-1 showed that the entry point when using MSVC was: 
int _tmain(int argc, _TCHAR* argv[]) 


The first four lines of the main function are used to obtain a random number. The srand function 
carries out an operation known as seeding. This uses the current time returned from the time 
function to generate a sequence of random numbers. 


// Generate unique random numbers using the current time 
srand(time(NULL) ); 


We declare and define a variable, numberToGuess, to store the value that we would like our player to 
guess. The rand function returns the number and we use the modulus operator (%) to ensure that the 
number remains less than 100. We cover the modulus operator in more detail in Chapter 3. 


// Get a random number between O and 99 
unsigned int numberToGuess = rand() % 100; 


The remaining code is similar to Listing 1-1. We use cout to write text for the player to read and use 
cin to allow the player to enter a guessed number. We finish by returning 0. 


cout << "Guess a number between O and 99" << endl; 


unsigned int playersNumber {}; 
cin >> playersNumber; 
cout << "You guessed: " 

<< playersNumber 

<< " The actual number was: 
<< numberToGuess 

<< endl; 


return 0; 
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Summary 


This chapter has given you a brief introduction to the built-in data types provided by C++ as well as 
also taking a look at enums and the usage of static_cast to convert between these built-in types. 


We then used this knowledge to create a very simple program to guess a number chosen by the 
computer. At the moment, we do not have the ability to test whether the player guessed correctly; 
that will come later in Part 1 when we look at flow control statements in Chapter 6. Chapter 3 covers 
the operators that are available in C++. Operators are the means with which C++ allows us to create 
logical programs that calculate and compute outcomes from our statements. 


Chapter 


Creating Calculators 
with Operators 


C++ provides operators that allow you to express all sorts of mathematical formulae in computer 
programs. You have access to operators that allow us to carry out algebra, compare values, and 
even manipulate the individual bit pattern of a variable’s value directly. This chapter is going to cover 
these C++ operators and end by having you create a simple command line calculator. 


The Assignment Operator 


The first operator we are going to look at is the assignment operator. We have already been using 
the assignment operator in the previous chapters as it is the operator that allows us to assign a value 
to a variable. This operator uses the = symbol: 


int number1 = 1; 


As you can see we have assigned the value of 1 to an integer variable named number1. We can also 
assign variable values to other variables: 


int number2 = number1; 


Here the program will read the value stored in number1 and assign that value to the variable number2. 
As we Saw in the previous chapter, the assignment operator can also automatically convert from one 
variable type to another. 


char charNumber = 1; 
int intNumber = charNumber; 


The assignment is one of the most widely used operators in C++; thankfully, it’s also easy to use and 
fairly obvious in nature. 
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The assignment operator can also be used in some pieces of code that aren’t necessarily very 
readable. Take the following line, for instance: 


number1 = number2 = number3 = 1; 


C++ compilers will evaluate these statements from right to left. 1 is assigned to number3, which 
would be assigned to number2, which would be assigned to number1, and all three variables will end 
up storing 1. | wouldn’t recommend writing code like this. 


Arithmetic Operators 
C++ also allows us to carry out basic arithmetic operations and we have five of these available: 
Addition operator 
Subtraction operator 
Multiplication operator 
Division operator 


Modulo operator 


The Addition Operator 


The addition operator behaves exactly as you would expect: It allows us to add two numbers 
together. The addition operator can add a value from the right to a value on the left and the result 
can be used in a statement, like this: 


int sum = number1 + number2; 


Here we have added number2 to number1 and stored the result in a third variable named sum. 


It is also possible to use the same values in all of the places in our addition statement, for example: 


int number = 1; 
number = number + number; 


Here we end up with 2 being stored in the variable number after this code has executed. 


The Subtraction Operator 


The subtraction operator works exactly like the addition operator, although unsurprisingly it subtracts 
one number from another and creates a result: 


int number1 = 2; 
int number2 = 1; 


int result = number1 - number2; 


This code would cause the value 1 to be stored in the variable result. 


CHAPTER 3: Creating Calculators with Operators 19 


The Multiplication and Division Operators 


These operators are also fairly self-explanatory; the multiplication operator multiplies numbers 
together and the division operator divides the number on the left by the number on the right: 


int number1 = 4; 

int number2 = 2; 

int multiplied = number1 * number2; 
int divided = number1 / number2; 


The result of the multiplication would be 8 and the result of the division would be 2. 


The division operator, like the subtraction operator, has a result that depends on the order of the 
variables. 


int divided1 = number1 / number2; 
int divided2 = number2 / number1; 


After executing these lines of code, divided1 would store 2 as earlier but divided2 would store 0 as 
4 cannot divide into 2. You can think of the results of the division as being rounded down to the 
nearest whole integer. The following example shows a similar result. 


int number1 = 5; 
int number2 = 2; 

int divided1 = number1 / number2; 
int divided2 = number2 / number1; 


In the preceding code, divided1 will contain 2 after execution. The actual math would be 5/2 = 2.5 
or 2 remainder 1, but as integers can only store whole numbers we lose the extra 0.5 or remainder. 
2/5 = 0 remainder 5, and again we lose the remainder; therefore divided2 will store 0. 


float divided2 = static_cast<float>(number2) / static_cast<float>(number1) ; 


Casting both numerator and denominator to float values (or dividing two float variables) would have 
yielded a result of 0.5f. This is why it is important to use the correct type of variable for the job at hand. 


The Modulo Operator 


Our guessing game in Listing 2-1 has already shown a usage of the modulo operator. This can be 
thought of as a remainder operator, as it will return the remainder of dividing one number by another. 


int numerator = 12; 
int denominator = 10; 


int remainder = numerator % denominator; 


The variable remainder shown here will store the value 2 as 12 divided by 10 equals 1 remainder 2. 
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A Simple Arithmetic Calculator 


We will now write a simple program that can show the results of the arithmetic operators. Listing 3-1 
shows the code that will take two numbers and add them together. This sample code was created 
using Xcode and the main function is suitable for creating command-line programs for OS X. 


Listing 3-1. Adding Two Numbers 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 


{ 


cout << "Enter your first number: 
float number1 = 0.0f; 
cin >> number1; 


<< endl; 


cout << "Enter your second number: " << endl; 
float number2 = 0.0f; 
cin >> number2; 


float result = number1 + number2; 
cout << "The result of adding your two numbers is: 
return 0; 


<< result << endl; 


} 


We once again use cin and cout to communicate with users and ask them to enter two numbers. 
We then store the result of an addition in the variable result and print the output to the console. 
An example of the output from this program is shown here: 


Enter your first number: 

40 

Enter your second number: 

10 

The result of adding your two numbers is: 50 


Listing 3-2 shows a subtraction version of this program. 


Listing 3-2. Subtracting Two Numbers 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 


{ 
cout << "Enter your first number: " << endl; 
float number1 = 0.0f; 
cin >> number1; 
cout << "Enter your second number: " << endl; 


float number2 = 0.0f; 
cin >> number2; 
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float result = number1 - number2; 
cout << "The result of subtracting your two numbers is: 
return 0; 


<< result << endl; 


} 
Listing 3-3 shows a multiplication version of this program. 


Listing 3-3. Multiplying Two Numbers 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 


{ 
cout << "Enter your first number: " << endl; 
float number1 = 0.0f; 
cin >> number1; 
cout << "Enter your second number: " << endl; 
float number2 = 0.0f; 
cin >> number2; 
float result = number1 * number2; 
cout << "The result of multiplying your two numbers is: " << result << endl; 
return 0; 

} 


Listing 3-4 shows a division version of this program. 


Listing 3-4. Dividing Two Numbers 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 

{ 
cout << "Enter your first number: " << endl; 
float number1 = 0.0f; 
cin >> number1; 


cout << "Enter your second number: " << endl; 
float number2 = 0.0f; 
cin >> number2; 


float result = number1 / number2; 

cout << "The result of dividing your second number into your first is: 
<< result << endl; 

return 0; 
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Last but not least, Listing 3-5 shows a modulo version of this program. 


Listing 3-5. Finding the Remainder Between Two Numbers 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 
{ 
cout << "Enter your first number: " << endl; 
int number1 = 0; 
cin >> number1; 
cout << "Enter your second number: " 
int number2 = 0; 
cin >> number2; 


<< endl; 


int result = number1 % number2; 

cout << "The remainder from dividing your second number into your first is: 
<< result << endl; 

return 0; 


} 


We have to change the variables in Listing 3-5 to int from float as the modulo operator can only 
operate on integer values. 


Now that we have covered the arithmetic operators, we will take a look at relational operators. 


Relational Operators 


C++ allows us to compare variable values using relational operators. These operators allow us to work 
out if two variables are equal, not equal, one is greater than the other, or one is less than the other. 
There are also operators to work out if variables are less than or equal, and greater than or equal. 


Each of these operators provides a true or false result that can be stored in a bool. C++ provides the 
following relational operators: 


Equality operator 
Greater-than operators 


Less-than operators 


Equality Operators 


The equals operator is ==. We can use this in the following way: 
bool isEqual = number1 == number2; 


isEqual will contain true if number1 and number2 store the same value; otherwise it will contain false. 
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C++ also contains an inequality operator that can be thought of as a not equals operation. It can be 
used as follows. 


bool isNotEqual = number1 != number2; 


As we can see, the inequality operator uses an exclamation mark before the equals symbol. 
This operator provides true when the two values are not the same and false if they are the same. 


Greater-Than Operators 


C++ also allows us to work out if a value stored in a variable is greater than another. We can do this 
as follows: 


bool isGreater = number1 > number2; 
We can also tell if a number is greater than or equal to another: 


bool isGreaterThanOrEqual = number1 >= number2; 


Less-Than Operators 


We can work out if a value is less than another using the less-than operator: 
bool isLessThan = number1 < number2; 

As with greater-than, there is a less-than or equal to operator: 

bool isLessThanOrEqual = number1 <= number2; 


We will create some small programs to show off the relational operators just as we did with the 
arithmetic operators. 


Simple Comparison Calculators 


Listing 3-6 shows the source code for a simple program that tests the equality of two values. 


Listing 3-6. Using the Equality Operator 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 
{ 


cout << "Enter your first number: " << endl; 
int number1 = 0; 


cin >> number1; 
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cout << "Enter your second number: " << endl; 
int number2 = 0; 
cin >> number2; 


bool result = number1 == number2; 

cout << "It is " 
<< result 
<< " that your first number is equal your second." 
<< endl; 


return 0; 


} 


This sample application was created using Microsoft Visual Studio. The program will end very 
quickly after the second value has been entered, so a good trick is to set a breakpoint on the return 
line using the F9 key and to use debug mode to run the program using the F5 key. 


The boolean value in this sample will be printed out as a 1 when the operation results in a true value 
and 0 when the result is false. 


Listing 3-7 shows a simple program using the inequality operator. 


Listing 3-7. The Inequality Operator 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 

{ 
cout << "Enter your first number: " << endl; 
int number1 = 0; 
cin >> number1; 


cout << "Enter your second number: " << endl; 
int number2 = 0; 
cin >> number2; 


bool result = number1 != number2; 

cout << "It is " 
<< result 
<< " that your first number is not equal your second." 
<< endl; 


return 0; 


} 


Listing 3-8 contains the source code for an example of the greater-than operator. 
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Listing 3-8. The Greater-Than Operator 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 
{ 


cout << "Enter your first number: 
int number1 = 0; 
cin >> number1; 


<< endl; 


cout << "Enter your second number: 
int number2 = 0; 
cin >> number2; 


<< endl; 


bool result = number1 > number2; 

cout << "It is " 
<< result 
<< " that your first number is greater than your second." 
<< endl; 


return 0; 


} 


Listing 3-9 shows a use of the greater-than or equal to operator. 


Listing 3-9. The Greater-Than or Equal To Operator 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
cout << "Enter your first number: " << endl; 
int number1 = 0; 
cin >> number1; 
cout << "Enter your second number: " << endl; 


int number2 = 0; 
cin >> number2; 


bool result = number1 >= number2; 
cout << "It is " 
<< result 
<< " that your first number is greater than" 
<< " or equal to your second." 
<< endl; 


return 0; 
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Listing 3-10 shows an example of the less-than operator. 


Listing 3-10. The Less Than Operator 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 
{ 


cout << "Enter your first number: " << endl; 
int number1 = 0; 

cin >> number1; 

cout << "Enter your second number: " 
int number2 = 0; 


cin >> number2; 


<< endl; 


bool result = number1 < number2; 

cout << "It is " 
<< result 
<< " that your first number is less than your second." 
<< endl; 


return 0; 


} 
Finally, Listing 3-11 shows a use of the less-than or equal to operator. 


Listing 3-11. The Less-Than or Equal To Operator 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 

{ 
cout << "Enter your first number: " << endl; 
int number1 = 0; 
cin >> number1; 


cout << "Enter your second number: " << endl; 
int number2 = 0; 
cin >> number2; 


bool result = number1 <= number2; 
cout << "It is " 
<< result 
<< " that your first number is less than 
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<< " or equal to your second." 
<< endl; 


return 0; 


} 


So far we have looked at arithmetic operators for carrying out basic mathematical operations and 
relational operators for comparing the values stored in variables. The next set of operators supplied 
by C++ is the bitwise operators, which allow us to modify the individual bits that make up our values. 


Bitwise Operators 


All of the values we have seen so far have been backed by bits stored in computer memory. 

In a binary computer system, a single bit can either contain a one or a zero. We represent higher 
numbers than these by using different patterns of bits. This section covers the operators that allow 
us to manipulate bits. 


As a programmer you will generally deal with data sizes in terms of numbers of bytes rather than 
numbers of bits. A byte is a collection of 8 bits. We have already seen that the char data type 
consists of a single byte and that an int consists of 4 bytes. This means that a char consists of 8 
bits and an int is 32 bits. 


We can think of the 8 bits of a byte as being represented in the same manner as in Table 3-1. 


Table 3-1. The Unsigned char Bit Sequence for 137 
128 64 32 16 8 4 2 1 


The bit sequence in Table 3-1 represents the unsigned char value of 137. We have a bit telling us 
that the value consists of a 1, an 8, and a 128. These are added together to give us 137. 


The bitwise operators allow us to set and unset individual bits, test if bits are set, and even merge bit 
patterns together. A set bit means that its value is 1 and an unset bit has the value 0. The rest of this 
section looks at the bitwise operators available in C++ as well as the hexadecimal representation of 
numbers. 


Hexadecimal Number Representation 


When we normally write numbers, such as 11, we are using the decimal number representation. 
Decimal numbers have a base 10 format. We say it is base 10, as we have 10 unique digits, 

0 through 9. Once we add one to 9 in a column, we reset the column to 0 and add a one to the 
column to the left, so 9 becomes 10, 19 becomes 20, and 1999 becomes 2000. 
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Note It’s probably not a coincidence that we have 10 fingers, or digits, on our hands and that our modern 
counting systems are all based on the base 10 number system. The binary numbers we have been looking at 
so far are actually numbers in the base 2 representation of numbers! 


Table 3-1 shows how we can represent numbers in the binary format. 1 is 1, 2 in binary is 10, and 137 
in binary is 10001001. Once we get to 32-bit values we have to keep track of 32 individual bits, and 
things are even worse now that we are seeing processors that can operate on 64-bit values. To make 
life easier for all, the hexadecimal number format can be used to represent large bitfields. Despite the 
“hex” part leading us toward believing that we are dealing with sets of six, hexadecimal values actually 
work in sets of 16, or base 16. The hexadecimal representation uses the digits 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 
A, B, C, D, E, and F where A, B, C, D, E, and F represent 10, 11, 12, 13, 14, and 15, respectively. 


Table 3-1 can be used to work out that the binary value 1111 is actually the number 15. We can 
represent the 8-bit value of 15 in C++ using the following line of code: 


unsigned char hex15 = OxOF; 


If we wish to print a value out onto the console in hex format we tell cout in the following manner: 
cout << std::hex << number << std::dec << number; 


For the rest of this section we use simple 8-bit binary representations of numbers to show how the 
bitwise operators change values in our code. This small section on hexadecimal numbers is useful, 
as we would use this format for binary values in source code for shipping game titles. 


C++ provides us with the following bitwise operators: 
AND operator 
OR operator 
Exclusive OR operator 
Left Shift operator 
Right Shift operator 


The Binary & (AND) Operator 


The & operator is known as the AND operator. Listing 3-12 shows how the & operator is used. 


Listing 3-12. The Bitwise & Operator 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


CHAPTER 3: Creating Calculators with Operators 29 


int _tmain(int argc, _TCHAR* argv[]) 
{ 


unsigned int first = OxOF; 
unsigned int second = 0x18; 
unsigned int anded = first & second; 


cout << hex << showbase; 
cout << first << endl; 
cout << second << endl; 
cout << anded << endl; 


return 0; 


Note We are using unsigned int and not unsigned char in these examples as cout prints character 
symbols when using char types but converts to human-readable numbers when using int types. 


We are using the & operator on the variables first and second in Listing 3-12 and storing the result 
in anded. The first use of cout tells the output stream that we would like to show numbers in the hex 
format. The showbase specifier tells the output stream that we would also like to show the Ox part of 
the number. The output from this program would look like the following: 


oxf 
0x18 
0x8 


OxOf and 0x18 were our input numbers and 0x08 is the output generated. Table 3-2 shows how we 
derive this result. 


Table 3-2. The Result of Using Bitwise & on OxOF and 0x18 
128 64 32 16 8 4 2 1 


first 0 0 0 0 1 1 1 1 
second 0 0 0 1 1 0 0 0 
anded 0 0 0 0 1 0 0 0 


Table 3-2 shows how we can derive 0x08 as the result of an & between OxOF and 0x18. We begin 
with the right-most column and work our way to the left. 


In the 1s column we have a 1 in first and a 0 in second; therefore the result bit is 0. 
In the 2s column we have a 1 in first and a 0 in second; therefore the result bit is 0. 


In the 4s column we have a 1 in first and a 0 in second; therefore the result bit is 0. 
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In the 8s column we have a 1 in first and a 1 in second; therefore the result bit is 1. 
In the 16s column we have a 0 in first and a 1 in second; therefore the result bit is 0. 
All other columns have Os in both values. 


As you can see, to be able to have a 1 in a bit column in our result value the corresponding bit 
column also had to be 1 in the first and second values. If either of the values was a 0 then the result 


bit at the same column is also a 0. 


The Binary | (OR) Operator 


The Bitwise |, or OR, operator is used to determine if either of the bits in a given column is set to 
1 in either of the two supplied values. Table 3-3 shows the result of using | with the same OxOF and 
0x18 values as the previous example. 


Table 3-3. The Result of Using Bitwise | on OxOF and 0x18 
128 64 32 16 8 4 2 1 


first 0 0 0 (0) 1 1 1 1 
second 0 0 0 1 1 0 0 0 
ord 0 0 0 1 1 1 1 1 


The result of the | on the two values is 0x1F. We derived this using the following method from 
left to right. 


In the 1s column we have a 1 in first; therefore the result bit is 1. 

In the 2s column we have a 1 in first; therefore the result bit is 1. 

In the 4s column we have a 1 in first; therefore the result bit is 1. 

In the 8s column we have a 1 in first; therefore the result bit is 1. 

In the 16s column we have a 1 in second; therefore the result bit is 1. 
All other columns have Os in both values. 


Using the | operator is as simple as using the & operator; however, the resulting bit for each column 
is set to 1 if either of the bits from the two input values were 1. 


The Binary “ (Exclusive OR) Operator 


Our last bitwise operator is the ^ (or Exclusive OR/XOR) operator. This operator differs from the | 
operator by requiring that one of the two input values bits is set, but not both. Table 3-4 shows this 


in practice. 
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Table 3-4. The Result of Using Bitwise ^ on OxOF and 0x18 
128 64 32 16 8 4 2 1 


first 0 0 0 0 1 1 1 1 
second 0 0 0 1 1 0 0 0 
xord 0 0 0 1 (0) 1 1 1 


The result from OxOF ^ 0x18 is 0x17. As you can see, every column that contains a 1 and a 0 resulted 
in a 1 being placed into the result. The columns that contain two 1s or two 2s all result in Os being 
stored. 


The Left Shift (<<) Operator 


You can use the left shift operator to move bits to the left by a specified number of bits. The following 
code shows how we can use the shift operator. 


unsigned int shifted = 1 << 1; 


If you print the value stored in shifted you will see that it contains the number 2. This is because the 
bit to the left of the first bit represents 2. The following patterns show what has happened. 


128 64 32 16 8 4 2 1 
0 0 0 0 0 0 0 1 
0 0 0 0 0 0 1 0 


If we had shifted the number of bits by 2 then shifted would have contained 4. When we use the 
left shift operator, all of the bits at the right of the pattern are set to 0. This ensures that we do not 
introduce new values into our variable. 


A more complicated way of thinking about the shift operator is to imagine that we are multiplying the 
left value by 2 raised to the power of the number of shifted bits. In our example, we had 1*(241)=2. 
If we had shifted by 4 bits we would have 1*244=16. 


The last thing you should consider when using left shift is what happens to values on the end. 
Consider the following line of code. 


unsigned int shifted = 0x80000000 << 1; 


This code shows that we will shift the end bit off of the end. In this case shifted will store O after 
execution. As all bits to the right of the shift are set to 0, any bits that are shifted out of the variable 
will be lost. 
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The Right Shift (>>) Operator 


The right shift operator carries out the opposite operation to the left shift operator. 


unsigned int shifted = 0x2 >> 1; 


shifted contains 1 after executing this line of code. Again, if you shift values off the end then they 
are lost. 


There is a significant difference between the left and right shift operators. When left shifting, all of the 
new values are set to 0. When right shifting the new bits depend on whether your value is a signed or 
unsigned type. Unsigned types have the values at the left of the bit pattern set to 0. Signed types have 
these set to the value contained in the sign bit. This means that positive values will have these bits set to 
0 and negative values will have these bits set to 1. If you’re having trouble remembering why this would 
be, you should go back over the description of twos complement numbers in the previous chapter. 


Bitwise operators can be fairly complex to get your head around, but they can be a very powerful 
tool for a programmer. The next set of operators that we will be looking at is the logical operators. 


Logical Operators 


We are going to cover logical operators here without covering any source examples. Logical 
operators are at their most useful when combined with flow control statements, which we will look 
at in Chapter 6. There are two logical operators: Logical AND (&&) and Logical OR (| |). These behave 
differently to the Bitwise & and | operators, so it is critical that you ensure that you are choosing the 
appropriate operator for the task at hand. 


Logical operators operate on two boolean values and return a boolean result. 


The && Operator 


The && operator simply tells us whether two booleans are both true. For example: 


bool isTrue = true && true; 

bool isFalse = false && true; 

bool isFalse = true && false; 

bool isFalse = false && false; 

bool isTrue = true && true && true; 


There isn’t any more to the && operator than this. 


The Il Operator 


The || operator is as simple as the && operator. Some results when using | | are as follows: 


bool isTrue = true || true; 

bool isTrue = false || true; 

bool isTrue = true || false; 

bool isFalse = false || false; 

bool isTrue = true || false || false; 
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As you can see, the result is only false when all parameters in the | | chain are false where they were 
all true, to provide a true result using &&. 


Another class of operators we can use in C++ are the unary operators. So far all of the operators we 
have looked at have required two input values to create an output value. Unary operators can work 
on a single variable. 


Unary Operators 


C++ provides a set of operators that can be used with a single variable as opposed to the operators 
that take two operands as we have seen so far. There are arithmetic, logical, and binary unary 
operators, which we look at in this section. First we take a look at the arithmetic unary operators. 


Arithmetic Unary Operators 


The arithmetic unary operators are the plus and negative operators, and the increment and 
decrement operators. 


Unary Negative Operator 


The unary negative operator is used to negate a given value just as we do in general arithmetic. -x 
means negate x. If x happened to be 4 then the value would become -4, if it was -3 the value would 
become 3. It can be used in C++ code as follows: 


int negatedValue = -4; 
int positiveValue = -negatedValue; 


positiveValue would contain 4 after executing these lines of code. 


Unary Plus Operator 


The unary plus operator simply returns the same value as it reads and therefore finds little use in 
practical programming. 


int valueA = 1; 
int valueB = +valueA; 


In the preceding code, valueB would also contain the number 1. 


The Increment and Decrement Operators 


The increment operator allows us to increase a value by one and the decrement operator allows 
us to decrease a value by one. If we place the operator before the variable name, it is said to be 
a preincrement or predecrement operator. If we place it after it is said to be a postincrement or 
postdecrement operator. Listing 3-13 shows a small MSVC program that outputs various values 
using these operators. 
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Listing 3-13. The Increment and Decrement Operators 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 
{ 
int value = 0; 
cout << value << endl; 
cout << value++ << endl; 
cout << ++value << endl; 
cout << value-- << endl; 
cout << --value << endl; 
return 0; 


} 


The output from this program is the following: 


ONNOO 


We achieve this in the following way. 0 is output in the first cout line as the variable value was 
initialized to 0. The second cout also prints 0 as the postincrement operator returns the value of the 
variable, then increases it; therefore, we print out O then add 1. The third cout uses a preincrement 
operator; therefore, 1 is added to the variable, giving 2, which is then returned to cout for printing. 
Our fourth cout uses a post decrement operator that causes the value 2 to be returned from the 
variable before it is decremented to 1. The last cout decrements the variable to 0 before returning it 
to the cout command for printing. 


These operators will be useful when we look at arrays in Chapter 4. 


The Logical Not Unary Operator 


Logical Not allows us to flip the value of a boolean value. Using !, true becomes false and false 
becomes true. We could determine if two values were not equal in the following way: 


bool notEqual = !(valueA == valueB); 


This is a simple example of how to use the ! operator. 


The One’s Complement Operator 


The operator, ~, can be used to flip all of the bits in a variable. Listing 3-14 shows a program to 
print the output from the ~ operator. 
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Listing 3-14. The ~ Operator 


#include "stdafx.h" 
#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
int test = 0x0000000F; 
cout << hex << “test; 
return 0; 

} 


This program will write out OxFFFFFFFO, which is the value 0x0000000F with all of the bits flipped from 
0 to 1 and 1 to 0. 


Summary 


In this chapter we have covered all of the basic operators that we will be using to construct 
procedural programs. These operators allow us to carry out arithmetic on variables, compare the 
relationships between values in variables, and even carry out complicated operations on individual 
bits inside variable values. 


Every program we write uses combinations of these operators to carry out complicated and complex 
tasks. The examples so far in this book have been basic programs that help us to understand the effects 
of these operators on the types provided by the C++ programming language. The examples beginning 
in Chapter 4 will actually start us on our journey into creating a text adventure game using C++. 


__ 


Chapter 


Beginning C++ Game 
Development with Arrays 


We will begin to create our first C++ game in this chapter. So far this book has looked at the various 
types supplied by the C++ programming language as well as the operators that can be used to 
alter and compare these types. The next major area of the C++ programming language that you 
should understand to begin constructing complex programs is data storage. The individual types in 
C++, such as int and char, can hold single values, but often we will want to be able to remember 
multiple values all relating to similar things. We could achieve this by creating a unique variable for 
every object with a value that we wish to remember; however, C++ provides us with arrays to store 
multiple values together. This chapter takes a look at how arrays are used in C++ and also explores 
how we can use arrays to begin our text adventure game. 


The C++ Array 


We looked at the various types supplied by C++ in Chapter 2, but each of the examples involved 
looking at only a single variable at a time. When writing programs, we would rather work with 
multiple pieces of data, as this is the type of task that computers are exceptionally good at. 

The following line of code shows how we can define an array that contains five integers. 


int intArray[5] = { 0, 1, 2, 3, 4 }; 


This code creates an array of five integers each containing the values 0 through 4. The individual 
variables contained within an array are often referred to as the elements of the array. Listing 4-1 
shows how we can use this array in a simple program. 
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Listing 4-1. C++ int Array 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
int intArray[5] = { 0, 1, 2, 3,4}; 
cout << intArray[0] << endl; 
cout << intArray[1] << endl; 
cout << intArray[2] << endl; 
cout << intArray[3] << endl; 
cout << intArray[4] << endl; 
return 0; 
} 


The array operator [] is used to specify an index into an array. The index is a value that specifies 
the offset of the variable that we would like to access. A common misunderstanding in computer 
programming is the fallacy that programmers “count” from zero. This is not strictly the case; 
programmers offset from zero and indexing into arrays is a perfect example of this. 


The index 0 specifies that we would like the first element from the array and the index 1 specifies 
that we would like the second element. Listing 4-1 supplied indexes to the array using hard-coded 
literal values. You can also index into an array using a variable. Listing 4-2 gives an example of this. 


Listing 4-2. A Variable Array Index 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 
{ 
int intArray[5] = { 5, 6, 7, 8, 9}; 


unsigned int index = 0; 


cout << "Index: " << index << endl; 
cout << "Value: " << intArray[index++] << endl; 


cout << "Index: " << index << endl; 
cout << "Value: " << intArray[index++] << endl; 


cout << "Index: " << index << endl; 
cout << "Value: " << intArray[index++] << endl; 


cout << "Index: " << index << endl; 
cout << "Value: " << intArray[index++] << endl; 


cout << "Index: " << index << endl; 
cout << "Value: " << intArray[index++] << endl; 
return 0; 
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We use an unsigned int as the array index, as we will never require a negative index into our array. 


Our index is initialized to 0 to access the first element and we use the post increment operator to 
increase the index by one after we print each value from the array. 


Note You must make sure to initialize the array index to 0 in Listing 4-2 to ensure that we access the first 
element of the array. If you had failed to initialize the index in production code, the variable could contain a 
random value and access memory outside of the array. This always leads to bugs that are hard to locate and 
fix. The same principle of always initializing should apply to all of your variables to avoid this problem. 


Listing 4-2 has also changed the values in the array to prevent the same values from being printed 
out for both the index and value lines. This helps show the relationship between the index and the 
values contained within the array. 


Arrays can be constructed using any type in C++. Listings 4-1 and 4-2 show arrays using the int 
type but we could just as easily have used float, short, or bool (for example). char arrays have 
special meaning in C++ under certain circumstances as they can be used to represent C style 
strings. 


Before we can look at the functions that C++ provides to manipulate C strings, you need to 
understand how pointers work and their relationship with arrays and memory. 


Pointers 


Pointers are a fundamental aspect of the C++ language that allows it to deliver fast runtime 
performance as a low-level programming language. Where variables allow us to manipulate the 
values stored at specific locations in memory, pointers let us manipulate variables that store 
addresses to other variables. 


The concept of pointers can be a difficult one to explain, so let’s jump straight into some examples. 


Listing 4-3 shows how we can use a pointer to find the value stored at a given memory address. 


Listing 4-3. Using Pointers in C++ 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 
{ 
int variable = 5; 
int* variablePointer = &variable; 


cout << "Value of variable: " << variable << endl; 


cout << "Address of variable: " << &variable << endl; 
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cout << "Value of variablePointer: " << variablePointer << endl; 


cout << "Value of variablePointer + 1: 
<< variablePointer + 1 << endl; 


cout << "Value of memory at dereferenced variablePointer: 
<< *variablePointer << endl; 


cout << "Value of memory at dereferenced variablePointer + 1: 
<< *variablePointer + 1 << endl; 


return 0; 


} 
This code creates an int variable and assigns it the value of 5. We then create a pointer to the variable. 


int variable = 5; 
int* variablePointer = &variable; 


The * operator after the type name tells the compiler that we are creating a pointer. A pointer is a 
variable with a value that is a memory address rather than an actual value. We assign the address of 
variable to variablePointer by using the address-of operator &. 


Figure 4-1 shows the output generated by the code in Listing 4-3. 


alue of variable: 5 

Address of variable: @164FB6C 
variablePointer: @164FB6C 
variablePointer + 1: 0104FB70 
memory at dereferenced variablePointer: 5 


memory at dereferenced variablePointer + 1: 6 


Figure 4-1. The output from Listing 4-3 


The first line shows the value of variable using cout as usual. 


cout << "Value of variable: " << variable << endl; 
The second line prints out the hexadecimal address of the variable using the address-of operator. 


cout << "Address of variable: " << &variable << endl; 
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The third line prints out the value of variablePointer. As variablePointer stores the address 
of the variable, the value output is the same. 


cout << "Value of variablePointer: " << variablePointer << endl; 


Pointer Arithmetic 


Listing 4-3 and Figure 4-1 show the results of pointer arithmetic. 
cout << "Value of variablePointer + 1: " << variablePointer + 1 << endl; 


This line shows that we can add to addresses stored by pointers; we can also subtract, multiply, 

and divide pointers. Addition and subtraction usually make the most sense. The program has printed 
0104FB6C as the address of variable. As the difference between the two addresses is 4 bytes, 
variablePointer + 1 is 0104FB70. This is not a coincidence. The size of an integer in my program 
is also 4 bytes. The compiler has added the size of 1 int to the address when we have used the 
addition operator with the int*. The compiler will always add on the size of the data type pointed to 
by the pointer multiplied by the number we are adding to the pointer variable. If our pointer had been 
a short it would have added 2 bytes, not 4. If we had added 5 to the int pointer, the compiler would 
have added 20 to the stored address. 


Dereferencing Pointers 


Once we have a pointer, we occasionally would like to know the value of the variable pointed to by 
the pointer. You can see this in action in the last two cout statements in Listing 4-3. 


cout << "Value of memory at dereferenced variablePointer: 
<< *variablePointer << endl; 


cout << "Value of memory at dereferenced variablePointer + 1: 
<< *variablePointer + 1 << endl; 


The pointer dereference operator is *. When this operator is used with a pointer variable, the 
compiler will fetch the value of the variable pointed to by the pointer. In this case we dereference 
the pointer and retrieve the value 5. The next line shows that the * operator is evaluated before the 
arithmetic operator. In this case the 1 is added to the value pointed to by variablePointer and not 
the address that is stored there; therefore the output from this line is 6. 


Pointers and Arrays 


The timing of the description of pointers goes hand in hand with the description of arrays as the 
array index operator is carrying out pointer arithmetic for us behind the scenes. Compare Listing 4-4 
with Listing 4-2. 
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Listing 4-4. Using a Pointer with an Array 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
int intArray[5] = { 0, 1, 2, 3, 4 }; 
cout << "Value: " << *intArray << endl; 
cout << "Value: " << *(intArray + 1) << endl; 
cout << "Value: " << *(intArray + 2) << endl; 
cout << "Value: " << *(intArray + 3) << endl; 
cout << "Value: " << *(intArray + 4) << endl; 
return 0; 

} 


Listing 4-4 creates a program that outputs the values stored in the array. However, it accesses the 
values in the array by manipulating a pointer as opposed to using the index operator. Once again we 
have used parentheses in our program to dictate the order in which our operators are evaluated. 


As you can see, the array is created as usual; however, this time it is clear that the variable intArray 
is actually a pointer to an int. We can manipulate the array variable using pointer arithmetic to 
achieve the same result as using the index operator. The first value is accessed by dereferencing the 
pointer, and each subsequent value is accessed by dereferencing the pointer after it has been offset 
using pointer arithmetic. 


Now that you know how to access arrays using either the index operator or pointers, we are ready to 
tackle C style strings. 


C Style Strings in Arrays 


Listing 1-1 showed the use of a C++ style string using the string class. We look at this class in 
detail in Chapter 13 once we have covered classes in more detail. Until then we can use arrays to 
represent C style strings. 


Note Itis recommended that STL strings are used in new programs. STL strings automatically resize to 
store strings of varying length and generally hide all of the complicated memory management processing that 
can be involved when working with C style strings. This chapter covers C style strings, as you are likely to 
come across these very often when dealing with older game code and legacy game engines or libraries. 


Listing 4-5 shows how we can access a C style string via pointer. 


Listing 4-5. A C Style String 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 
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{ 
char* cStyleString = "CStyleString"; 
cout << cStyleString << endl; 
return 0; 

} 


The value "CStyleString" in quotes is known as a string literal. The compiler creates a table of all of 
the string literals in our program and stores them together in memory. We can access these string 
literals by assigning them to a char*. When we use cout with a char* that stores the address of a 
string literal it will print out the entire string and then stop. 


C++ achieves this by adding an extra character to the end of C style strings, the null terminator. We 
can see this in action using the code in Listing 4-6. 


Listing 4-6. The NULL Terminator 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
char* cStyleString = "CStyleString"; 
cout << (cStyleString[12] == '\o') << endl; 
return 0; 

} 


This program will print out a 1 as the 13th character of our string matches the null terminator 
character, \0. As you can see, we can store the address of the string into a char*, and we can then 
access individual characters using either pointer arithmetic or array indexing. 


Note Characters by default in C++ programs (and in this book) all use the American Standard Code for 
Information Interchange (ASCII) encoding. ASCII characters can be represented using single quotes such as 
"a'. The null terminator is a special character and as such must be preceded by a \, '\o' using '0' would 
represent the number zero and not the null terminator character. The actual decimal value of 'a' is 87, '0' 
is 48, and '\o' is 0. You can find a full list of ASCII values at www. asciitable.com/ 
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Working with C Style Strings 


C++ provides functions to work with C style strings. We cover how functions operate and write our 
own in Chapter 5; for now we list the different functions that C++ provides to work with strings. 


strlen 


strlen tells us how many characters are in a given string excluding the null terminator; this is 
shown in Listing 4-7. 


Listing 4-7. strlen 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
char* cStyleString = "CStyleString"; 
cout << strlen(cStyleString) << endl; 
return 0; 

} 


This program outputs 12. 


strcmp 


strcmp compares two strings and returns 0 if they match. Listing 4-8 contains an example. 


Listing 4-8. strcmp 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
char* cStyleString1 = "CStyleString"; 
char* cStyleString2 = "CStyleString"; 
cout << strcmp(cStyleString1, cStyleString1) << endl; 
return 0; 
} 


This program outputs 0. 
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strcpy 


strcpy copies a string from one array into another. Listing 4-8 provides an example. 


Listing 4-8. strcpy 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
char* cStyleString1 = "CStyleString"; 
char cStyleString2[13]; 
strcpy(cStyleString2, cStyleString1) ; 
cout << cStyleString2 << endl; 
return 0; 

} 


Its important to note that cStyleString2 contains enough space to store the 12 characters of the 
string literal plus an extra character for the null terminator. 


strcat 


strcat allows us to join, or concatenate, two strings. Listing 4-9 provides an example. 


Listing 4-9. strcat 


#include <iostream> 
using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 

{ 
char cStyleString1[13]; 
strcpy(cStyleString1, "CStyle"); 
char* cStyleString2 = "String"; 
strcat(cStyleString1, cStyleString2); 


cout << cStyleString1 << endl; 


return 0; 


} 


cStyleString1 must have enough space to store the combined string, therefore we create an array 
with space for 13 characters. We then use strcpy to copy "CStyle" into this array. strcat is used to 
copy "String" into the end of cStyleString1 from cStyleStringz2. 
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Note There are more functions supplied by C++ for working with C style strings; however, it is better to use 
the string class supplied by the Standard Template Library (STL) in modern C++ programs. We cover 

STL strings in Chapter 13. You can find a reference for C style string functions at 

www. cplusplus.com/reference/cstring/ 


Text Adventure Game 


As you work through this book we will build a text adventure game on the console. In this chapter 
we have looked at arrays, pointers, and C style strings. In the last two chapters we have looked at 
types, operators, and interacting with the user using cin and cout. 


We will begin by making our game a personal experience by asking the players for their name. 
This will be used to make the game seem as though it knows the players while they play through the 
game. Listing 4-10 shows the code that asks the players for their name. 


Listing 4-10. Asking for the Player’s Name 


#include <iostream> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
cout << "Welcome to Text Adventure!" << endl << endl; 
cout << "What is your name?" << endl << endl; 
char playerName[1024]; 
cin >> playerName; 
cout << endl << "Hello " << playerName << endl; 
return 0; 


This code stores the player’s name into a char array that contains 1,024 letters. The game would run 
into trouble if the player was to enter more characters than this, so we will use a string instead, as 
shown in Listing 4-11. 


Listing 4-11. Using an STL String for the Player Name 


#include <iostream> 
#include <string> 


using namespace std; 


int _tmain(int argc, _TCHAR* argv[]) 

{ 
cout << "Welcome to Text Adventure!" << endl << endl; 
cout << "What is your name?" << endl << endl; 
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string playerName; 
cin >> playerName; 


cout << endl << "Hello " << playerName << endl; 


return 0; 


} 


Now the players can enter a name as long or as short as they like without issue. We will cover why 
the string class is safer than a character array in Chapter 13. 


Note We could use character arrays for player input until we cover strings. However, | do not like to 
encourage the development of bad habits. If a player was to enter too many characters for our array to hold 
we would suffer a buffer overrun and introduce bugs into our code that will cause the program to crash. STL 
string does not suffer from this problem for reasons that are covered in Chapter 13. 


Summary 


This chapter has covered C++ arrays that allow us to store groups of data of the same type in 
contiguous memory. Contiguous means that the elements of the array follow each other directly in 
memory without having to jump to another location. 


This can be seen in action when we index arrays or carry out pointer arithmetic. Modern processors 
are designed with caches to operate at peak efficiency when dealing with contiguous memory 
addresses and arrays, therefore, are vitally important to the performance of modern video games. 


We cover more exotic data layouts later in this book when we introduce the STL, but it is important 
to understand arrays to be able to write fast and efficient code under many circumstances. 


C style strings are also an important concept to understand. Many current games are still written using 
this style of string, although the STL provides a better string class implementation. This is usually 
because it can still be faster to operate on arrays directly rather than work with classes. However, 
accessing arrays directly comes with some concerns about program stability, especially when dealing 
with user input. Overrunning the end of a buffer and overwriting memory used by other variables is a 
common cause of hard-to-find bugs and potential security vulnerabilities in many games. 


This chapter also introduced the concept of a function. Chapter 5 covers functions in more detail 
and you will learn how to write some of your own. 


Chapter 


Functions, the Building Blocks 
of C++ 


Modern games consist of hundreds of thousands of lines of code and can be worked on by teams 
consisting of hundreds of people. C++ provides the ability to separate code into blocks called 
functions to allow us to build more modular programs. 


A function allows us to write a routine that can be reused throughout our program. The benefits of 
this are significant. You saw this in the last chapter when we looked at some of the C++ functions 
for working with strings. We did not have to write our own code to determine if two strings were the 
same; instead, we could simply pass them both into a function and the return value told us the result 
of the function. 


This chapter covers how we write functions, including how to pass values to a function, how to pass 
pointers to functions, and a special type of pointer, the reference. 


Writing Our First Function 


A C++ compiler requires that functions are declared and defined before they can be used, just as 
with variables. It’s also possible to define and declare a function at the same time. Listing 5-1 shows 
the code for a simple program that calls a single function. 


Listing 5-1. Our First Function 


#include <iostream> 
using namespace std; 


void PrintHello() 
{ 


} 


cout << "Hello!" << endl; 
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int _tmain(int argc, _TCHAR* argv[]) 
{ 
PrintHello(); 


return 0; 


} 


Listing 5-1 contains a function named PrintHello. Functions in C++ always follow the same 
format and PrintHello is as simple as a function can be. It does not return any values to the 
code that calls the function and we also cannot pass any parameters to the function. To tell the 
C++ compiler that we do not want the function to return a value, we specify void as its return 
type. We can call a function by placing its name in our code followed by parentheses, as we have 
done with PrintHello. 


Passing Parameters to Functions 


Functions tend to be more useful when we can pass values to them. We do this by specifying 
parameters in the function signature. Listing 5-2 shows a function that contains parameters in its 
signature. 


Listing 5-2. Passing Values to Functions Through Parameters 


#include <iostream> 
using namespace std; 


void PrintSum(int valueA, int valueB) 


cout << valueA + valueB << endl; 
} 

int _tmain(int argc, _TCHAR* argv[]) 
PrintSum(3, 6); 

return 0; 


The function PrintSum takes two parameters. Both parameters are of the type int and are 
named valueA and valueB. When we call PrintSum in _tmain we pass it the values 3 and 6. 
Inside the function the variable valueA contains the value 3 and valueB contains 6. The output 
from the program is 9. Another way to achieve this result would be to return the sum from the 
function. 
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Return Values 


Functions can return values to the calling code to be stored within variables or passed as 
parameters to other functions. Listing 5-3 shows how to return a value from the function. 


Listing 5-3. Returning Values from Functions 


#include <iostream> 
using namespace std; 


int ReturnSum(int valueA, int valueB) 


{ 
return valueA + valueB; 
} 
int _tmain(int argc, _TCHAR* argv[]) 
{ 
int sum = ReturnSum(3, 6); 
cout << sum << endl; 
return 0; 
} 


The function ReturnSum has a new return type in its signature: It now reads int rather than void. 
Inside the function you now see that we use the return keyword to return the value from the + 
operator. We store the returned value from ReturnSum into the variable sum, which is then used with 
cout to print the result 9 to the console. 


Any of the built-in types can be used as parameter or return types. The functions we have looked at 
in Listings 5-1, 5-2, and 5-3 all pass and return their function by value. This means that the compiler 
will make a copy of the values when they are being passed to or from the function. Sometimes we 
would like to be able to alter the values that come into our function so that the calling code can 
access the new values, and we can do this by passing in pointers. 


Passing by Pointer 


Listing 5-4 alters our previous example to pass the result of our sum back to the calling code using a 
pointer. 


Listing 5-4. Passing by Pointer 


#include <iostream> 
using namespace std; 


void ReturnSum(int inValueA, int inValueB, int* outValue) 


{ 
} 


*outValue = inValueA + inValueB; 
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int _tmain(int argc, _TCHAR* argv[]) 


{ 
int sum = 0; 
ReturnSum(3, 6, &sum); 
cout << sum << endl; 
return 0; 


Listing 5-4 initializes the variable sum to contain the value 0. ReturnSum now does not return a 
value; instead it takes a pointer to an int as its third parameter. When we call ReturnSum we pass 
the address of sum using &sum. Inside ReturnSum we alter the value stored at the pointer using the 
following line: 


*outValue = inValueA + inValueB; 


The pointer dereference operator is used to tell the compiler that we want to change the value stored 
at the pointer and not the pointer itself. In Listing 5-4 this achieves the result of altering the value of 
sum from 0 to 9. 


Note Pointers can be set to not contain a value. This is achieved by assigning nullptr to them. We’ll cover 
nullptr in Chapter 6 when we look at flow control statements. 


As well as being able to pass values by pointer, we can also pass them by reference. 


Passing by Reference 


When we pass by pointer we must explicitly dereference the pointer to be able to retrieve its value. 
There’s also a possibility that the pointer might not point to a valid memory address but instead be 
assigned a nullptr. If we dereference a nullptr our program will crash. If we use a reference then 
we do not have to deference to obtain the value, we do not have to worry about nullptrs and we do 
not have to use the address of operator when passing the initial variable to the function. You can see 
this in Listing 5-5. 


Listing 5-5. Passing by Reference 


#include <iostream> 
using namespace std; 


void ReturnSum(int inValueA, int inValueB, int& outValue) 


{ 
} 


outValue = inValueA + inValueB; 
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int _tmain(int argc, _TCHAR* argv[]) 


{ 
int sum = 0; 
ReturnSum(3, 6, sum); 
cout << sum << endl; 
return 0; 

} 


We now use the reference operator on the type for outValue; this looks like int&. We’re beginning 
to see the same operators being used for different purposes in different contexts. When defining 

a variable, the & operator after the typename tells the compiler to make the variable a reference. 
When placed before a variable name, when assigning to a variable, or when passing to a function it 
becomes the address-of operator. 


Sooner or later in our programs we will want to pass large amounts of data into a function. One 
option could be to add many parameters to the function signature, but this makes the code difficult 
to maintain, as every time we change the function signature we will also have to change every call. 
Luckily structures provide an alternative. 


Structures 


So far all of the variables we have been using have been single variables. Individual variables are 
useful, but sometimes they can only take us so far. We will alter the sum example once again to 
show how we can use a structure with a function. Listing 5-6 shows an example of passing a 
structure to a function. 


Listing 5-6. Passing a Structure to a Function 


#include <iostream> 
using namespace std; 


struct SumParameters 


{ 
int valueA; 
int valueB; 
int result; 
}; 
void ReturnSum(SumParameters& params) 
{ 
params.result = params.valueA + params.valueB; 
} 


int _tmain(int argc, _TCHAR* argv[]) 
{ 
SumParameters sum; 
sum.valueA = 3; 
sum.valueB = 6; 
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sum.result = 0; 
ReturnSum(sum) ; 
cout << sum.result << endl; 


return 0; 


} 


Listing 5-6 begins by defining our structure. We do this using the struct keyword. Immediately 
after the keyword is the name we would like to use for our structure. This name behaves as though 
we have created a new type. We can see this in the first line of _tmain where we declare the 
variable sum. 


Once we have a variable that is of a structure type, we can use the . operator to access its member 
variables. We assign the values 3, 6, and 0 to the members of sum and then pass it by reference 

to the function ReturnSum. The compiler would have made a copy of all three members if we had 
passed the structure by value and therefore we would not have been able to read the proper result of 
the sum from the result member. 


You can use the information you have learned about functions in this chapter to modify the game we 
have been writing. 


Adding Functions to Text Adventure 


We began our Text Adventure game in Chapter 4. At that time you didn’t know that we could store 
data in structures or that we could use functions to make more readable programs. In this chapter 
we will create a structure for the player and create a function that will be responsible for welcoming 
the player. We do both of these in Listing 5-7. 


Listing 5-7. Adding the Player struct and WelcomePlayer Function to Text Adventure 


#include <iostream> 
#include <string> 


using namespace std; 


struct Player 
{ 


}3 


string m_name; 


void WelcomePlayer(Player& player) 

{ 
cout << "Welcome to Text Adventure!" << endl << endl; 
cout << "What is your name?" << endl << endl; 


cin >> player.m_name; 


cout << endl << "Hello " << player.m_name << endl; 
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int _tmain(int argc, _TCHAR* argv[]) 


{ 
Player player; 
WelcomePlayer(player) ; 
return 0; 

} 


Our program is now much more readable than before. The Player structure will be responsible for 
storing all of the data related to our player object; for now we only need to keep track of the player’s 
name. We pass the player variable by reference to the WelcomePlayer function. This allows us to add 
all of the code necessary to welcome our players to a single function and this function can assign 
the player’s name from cin directly into the Player reference. 


Our _tmain function now has code that is almost plain English. This is the goal of our code for the 
most part. Code that is human readable is very valuable when writing game programs. A lot of 
the code written, especially code to be reused between projects, must be maintained by teams of 
programmers. Having code that can be understood just by reading through it reduces the time it 
takes to understand and make alterations to the code. 


Summary 


This chapter has covered the C-style functions and structures you can use while writing programs 
in C++. Functions are the basic building blocks that allow us to write procedural programs. We have 
learned how to use parameters and return values to help us write readable programs. We’ve also 
looked at how pointers and references can be used to pass data into and out of functions. Finally, 
we looked at how we can group variables into structures. Grouping data in this way allows us to 
create our own types within the language. These types also aid us in writing programs that other 
programmers can easily understand. You saw this put to good effect in our Text Adventure game 
when we created a Player structure to group together data relating to our player. 


Our programs are beginning to take a real form but they are still limited to carrying out basic 
arithmetic. In the next chapter we will look at control flow statements that will allow our programs to 
make decisions or repeat tasks over a large set of data. 


Chapter 


Making Decisions with Flow 
Control 


The programs that we have been writing until now have been very linear. That is, they begin with the 
first line in main and carry on executing each line at a time until the program finishes with the return 
statement on the last line of main. Sometimes we might decide to carry out different code paths 
based on values we have stored in variables or repeat a section of code until some condition is 
satisfied. 


C++ provides us with statements that allow us to carry out these decisions and repetitions. This 
chapter introduces the if, switch, for, and while statements. These statements collectively are 
known as the flow control statements. We'll end the chapter by using flow control statements to add 
some decision making to our Text Adventure game. 


The if Statement 


The first flow control statement that we will look at is the if statement. This statement allows us to 
execute inside its curly braced block if the boolean we pass to it is true. Listing 6-1 shows a simple 
if statement. 


Listing 6-1. The if Statement 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 
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if (true) 
{ 


} 


return 0; 


cout << "Print This!"; 


} 


This if statement will always enter into the block associated with it. This block begins with the 
opening curly brace immediately following the statement and ends with the corresponding closing 
curly brace. If we were to change the value in the expression from true to false the block would not 
be entered and we would not see the output printed on the console. 


Note The examples in this chapter have been created using Xcode. Be sure to check that the main 
statement is correct for the integrated development environment (IDE) and platform you are using. 


The else and else if Statements 


The if statement allows us to make decisions in our code but usually we also want to be able to 
execute code on other conditions or as a default. We can use the else and else if statements to 
add more execution blocks to our if statements. Listing 6-2 shows how to use the else statement. 


Listing 6-2. The else Statement 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 


{ 
if (false) 
{ 
cout << "Print This When True!"; 
} 
else 
{ 
cout << "Print This When False!"; 
} 
return 0; 
} 


Our if statement now evaluates to false. If this were to happen in Listing 6-1, we would see no 
output from our program; however, the else statement in Listing 6-2 ensures that we will still see 
output. Listing 6-3 adds an extra if into the code. 
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Listing 6-3. The else if Statement 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 


{ 
if (false) 
{ 
cout << "Print This When True!"; 
else if (true) 
{ 
cout << "Print This When Else If Is True!"; 
} 
else 
{ 
cout << "Print This If All False!"; 
} 
return 0; 
} 


Here you can see that the extra else if statement will cause the code to execute its block and miss 
the else block. Listing 6-4 shows that we can have multiple else if blocks. 


Listing 6-4. Multipleelse if Blocks 


#include <iostream> 
using namespace std; 
int main(int argc, const char * argv[]) 


if (false) 
{ 


else if (false) 


cout << "Print This When True!"; 


cout << "Print This When First Else If Is True!"; 


} 


else if (true) 


{ 
} 


cout << "Print This When Second Else If Is True!"; 
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else 
{ 
cout << "Print This If All False!"; 
} 
return 0; 


} 


We can, in fact, have as many else if statements as we like. The else statement is also optional: It 
is completely valid to have cases where no else statement is necessary. 


Now we'll take a look at the for loop, which allows us to execute the same code block multiple 
times. 


The for Loop 


The for loop allows us to iterate as many times as necessary. Listing 6-5 shows a simple for loop in 
action. 


Listing 6-5. A for Loop 


#include <iostream> 
using namespace std; 
int main(int argc, const char * argv[]) 


for (unsigned int i=0; i<10; ++i) 


cout << "Loop Iteration: " << i << endl; 


} 


return 0; 


} 


The for loop statement consists of three parts: 


An initializer, which sets the initial value of the loop index variable 
(i.e., unsigned int i=0). 


A test, in which the loop will continue to execute until the test statement 
evaluates to false (i.e., i<10). 


A continuation statement, which is executed at the end of each successful loop 
before starting the next one (i.e., ++i). 


The for loop in our example results in the output being printed to the console 10 times with the 
values 0 through 9 appended to the end. 


A more powerful example of this is to combine the for loop with an array, as shown in Listing 6-6. 
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Listing 6-6. A for Loop Over an Array 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 


{ 
unsigned int array[10]; 
for (unsigned int i=0; i<10; ++i) 
{ 
array[i] = i * 2; 
cout << "Loop Iteration: " << array[i] << endl; 
} 
return 0; 
} 


This example shows how we can use the for loop index variable to index into an array. Here we 
initialize each element of the array via iteration and print the results to the console. We can use this 
technique to execute code on each element of an array, which is especially useful when writing 
games. 


Sometimes we do not know beforehand how many iterations of a given loop we would like to 
execute. Thankfully C++ provides us with another loop statement that can handle this case, the 
while loop. 


The while Loop 


A while loop just executes until its accompanying statement evaluates to false. Listing 6-7 shows a 
simple example. 


Listing 6-7. Awhile Loop 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 
{ 
unsigned int array[10]; 
unsigned int count = 0; 
while (count < 10) 


{ 

array[count] = count * 2; 

cout << "Loop Iteration: " << array[count++] << endl; 
} 
return 0; 
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Another type of while loop is the do. . . while loop. Listing 6-8 shows an example of this type. 


Listing 6-8. Ado. . . while Loop 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 
{ 
unsigned int array[10]; 
unsigned int count = 0; 


do 
array[count] = count * 2; 


cout << "Loop Iteration: 
} while (count < 10); 


<< array[count++] << endl; 


return 0; 


} 


The main difference between these two types of loop is that the do. . . while version will always 
execute at least once. The test occurs at the end of the first iteration of the do. . . while whereas 
the test occurs at the beginning of a standard while loop. 


If count in Listing 6-7 had been initialized to 10, the loop would never have run, whereas in 
Listing 6-8 it would have run once (and caused an array overrun). 


There are also times when we are programming when we want to execute specific code for a given 
value contained in a variable. C++ provides the switch statement for these moments. 


The switch Statement 


A switch statement can be used in place of anif...else if block when we have a set of literal 
values that we wish to differentiate between. Listing 6-9 shows an example using an enum. 


Listing 6-9. The switch Statement 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 


{ 
enum class Colors 
{ 
Red, 
Green, 
Blue 
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Colors color = Colors::Red; 
switch (color) 


{ 


case Colors: :Red: 


{ 
} 


break; 


cout << "The color is Red!"; 


case Colors: :Green: 


{ 
} 


break; 


cout << "The color is Green"; 


default: 
{ 


} 


break; 


cout << "Unknown color!"; 


} 


return 0; 


} 


You can see from this example that the switch statement can be used to create blocks of code 
(cases) that will execute for values that we are aware of at compile time. enums are perfect 
candidates for this type of statement. Listing 6-9 did not include a case block for the Blue value. This 
omission allowed us to look at the default case. The default case is supplied to provide a default 
behavior to the switch so that we can properly handle situations that need either a default behavior 
or to catch an error. 


Listing 6-9 also sees the introduction of the break keyword. This new keyword allows us to break 
out of a statement block. If we had missed this in our switch, the program would have created the 
following output (assuming we add endl to each line): 


The color is Red! 
The color is Green! 
Unknown color! 


Missing the break in each block would cause the code to flow from one block to the next. 
Sometimes this is the behavior we desire, but more often than not it is a bug. 


Note This is our first mention of code bugs! Games are large projects and bugs can be caused by many 
complicated interactions in code. This example of missing a single word is just one example of how bugs can 
enter our code. 
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The break statement can be used to exit any of the loops we have covered in this chapter. If we had 
a for loop and had a condition where we would like to stop execution, then we would be able to 
use break, and the same goes for both versions of the while loop. C++ also provides the continue 
keyword to control loops. 


The break and continue Keywords 


Listing 6-10 shows an example loop that contains both the continue and break statements. 


Listing 6-10. Using continue and break 


#include <iostream> 
using namespace std; 


int main(int argc, const char * argv[]) 


{ 
unsigned int array[10]; 
unsigned int count = 0; 
do 
{ 
if ((count % 2) == 0) 
{ 
++count; 
continue; 
} 
array[count] = count; 
cout << "Loop Iteration: " << array[count++] << endl; 
if (count == 10) 
break; 
} 
} while (true); 
return 0; 
} 


The output from our program is the following: 


Loop Iteration: 
Loop Iteration: 
Loop Iteration: 
Loop Iteration: 
Loop Iteration: 


WOoONOW PB 
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The first if statement that contains a mod operator and a relational equals operator tells the loop 
to skip all of the even numbers when executing. Our output shows this by printing the current 
iteration count. 


The second if statement tells the loop to break once the count reaches 10. The last flow control 
statement that we will look at in this chapter is the goto. 


The goto Statement 


The goto statement is frowned on by modern C++ developers, so | include it in this chapter merely 
for the sake of completeness, so that you are aware of its existence and can work with it in legacy 
code. 


Note goto really is a rare sight in code today. In eight years | have only ever seen it used in a single 
game! This Wikipedia entry explains some of the concerns that exist with the goto statement: http: // 
en.Wikipedia.org/wiki/Goto#Criticism_and_decline 


Listing 6-11 modifies Listing 6-10. This time we use a goto to end the loop rather than a break. 
Listing 6-11. The goto Statement 
#include <iostream> 


using namespace std; 


int main(int argc, const char * argv[]) 
{ 
unsigned int array[10]; 
unsigned int count = 0; 


do 
{ 
if ((count % 2) == 0) 
++count; 
continue; 


} 


array[count] = count; 
cout << "Loop Iteration: 


<< array[count++] << endl; 
if (count == 10) 
goto finished; 


} 
} while (true); 
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finished: 
return 0; 


} 


A goto consists of two parts: 
A label 
The goto statement 


A label is inserted into the code, which creates a named point to which we can jump. In this example 
our label is finished. We can then use this label to have the goto command jump directly to that 
point. 


| have seen this used to move between the game loop, the frontend loop and a pause loop in game 
code before. It's also been known for goto to be used to jump to error handling code. This might 
seem to be a good idea, but there are always better options such as using break, a state machine for 
game state, or return values or exceptions for handling errors. 


In this chapter we have covered the essential flow control statements provided by C++. It's now time 
to put these to good use in our Text Adventure game. 


Adding a Game Loop to Text Adventure 


For our Text Adventure to be a compelling game, we must add a loop that allows the player to 
interact. We looked at the for loop and the while loop in this chapter. A for loop provides us with a 
set number of iterations, so a while loop would be better suited to our needs for a game loop. 


Listing 6-12 shows how we can use an enum, functions, references, relational operators, and a while 
loop to write code that begins to resemble an interactive program. 


Listing 6-12. The Text Adventure Game Loop 


#include <iostream> 
#include <string> 


using namespace std; 
The Player struct and WelcomePlayer functions have not changed since Chapter 5. 


struct Player 


{ 
}3 


string m_name; 


void WelcomePlayer(Player& player) 

{ 
cout << "Welcome to Text Adventure!" << endl << endl; 
cout << "What is your name?" << endl << endl; 
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cin >> player.m_name; 


cout << endl << "Hello " << player.m_name << endl; 


} 


We create a new function, GivePlayerOptions, to display the different choices players currently have 
available to them. 


void GivePlayerOptions() 


{ 
cout << 
"What would you like to do? (Enter a corresponding number)" 
<< endl << endl; 
cout << "1: Quit" << endl << endl; 
} 


The GetPlayerInput function reads the player's commands from the console and stores them into a 
string reference. 


void GetPlayerInput(string& playerInput) 
{ 


} 


cin >> playerInput; 


We use an enum, PlayerOptions, to represent the choices the players can enter. For now we only 
have representations of Quit and None. 


enum class PlayerOptions 


{ 
Quit, 
None 
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This function takes a reference to a string that represents a choice that could be made by the player. 
The literal string "1" is used to represent the Quit option at the moment. 


We use an if. . . else statement here to decide whether the player has entered an option that we 
recognize. Strings can be compared using the compare function and will return 0 if the two strings 
match. If the player's input matched "1" we set the chosenOption value to PlayerOptions: :Quit, and 
it is initialized to PlayerOptions: :None. chosenOption is used as the return value of the function. 


PlayerOptions EvaluateInput(string& playerInput) 
PlayerOptions chosenOption = PlayerOptions: :None; 
if (playerInput.compare("1") == 0) 
{ 


cout << "You have chosen to Quit!" << endl << endl; 
chosenOption = PlayerOptions: :Quit; 
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else 


{ 


cout << "I do not recognize that option, try again!" 
<< endl << endl; 


} 


return chosenOption; 


} 


The RunGame function returns a bool, the shouldEnd variable. This function is designed to be called 
from a loop and simply calls the other functions that represent the different stages of our game at 
the moment. The return value from EvaluateInput is checked to determine if the player has decided 
to quit the game. 


bool RunGame() 
bool shouldEnd = false; 
GivePlayerOptions(); 


string playerInput; 
GetPlayerInput (playerInput) ; 


shouldEnd = EvaluateInput(playerInput) == PlayerOptions: :Quit; 


return !shouldEnd; 


} 


Our program's entry point is still the main function. This function calls WelcomePlayer then executes a 
while loop that will iterate until the player has selected the quit option. 


int main(int argc, const char * argv[]) 


{ 
Player player; 
WelcomePlayer(player) ; 


bool isPlaying = true; 
while (isPlaying) 
{ 

isPlaying = RunGame(); 


return 0; 


} 


We have now written a program that is beginning to resemble a game. We have put the core game 
loop into place and from here we will be able to add new functionality to our existing functions. 
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Summary 


This chapter has introduced the flow control statements that are a core part of the C++ programming 
language. These statements allow us to write game code that creates compelling interactive 
experiences for our players. We can use if and switch statements to execute different code paths 
depending on the values stored in variables at runtime. These values could be calculated from the 
current state of the game or might be obtained from player input. You have also seen how we can 
use loops to execute code repetitively. The for loop can be used to carry out an iterative block of 
code over a fixed number of iterations and the while loop can be used to continue iterating until 
some condition is met. You’ve also seen how we can use the continue and break keywords to gain 
finer control over our loop execution. 


We then used what we have learned to build a game loop for our Text Adventure game. We read 
input from the player inside a while loop until they enter the option to quit. We used an if statement 
to determine if the option the user entered matches the value we have chosen to represent quit. 


The next chapter looks at program structure. It will show you how we can split our code across 
multiple source files so that we can create projects that are more manageable. So far our program 
has been relatively short and we have been working on our own. Professional game projects can 
have tens of thousands of files and tens to hundreds of programmers all working at the same time. 
You will learn how you can use source and header files, as well as namespaces, to modularize 
your code. 


Chapter 


Organizing Projects Using Files 
and Namespaces 


In Chapter 6 we ended with a file that contains functions and structures that were related to completely 
different high-level concepts. Some were there to control the game loop, others to obtain user input and 
write output, and a structure to represent the player model. Eventually this code would become difficult 
to manage and work with if we were to continue down this path of adding everything to a single file. 


We have already seen that we can split new functions into declarations and definitions as well as 
being able to use the #include directive to be able to use functionality that is contained within 
separate files. All of the examples we have used so far have used the using namespace std; 
directive. In this chapter we look at how we can organize our own programs into separate files and 
also create namespaces to group together functionality. To wrap up, we’ll use what we learn to 
reorganize our Text Adventure game to allow us to expand more easily in the coming chapters. 


Source and Header Files 


C++ supports the ability to separate code out into separate source and header files to better 
organize programs. The header files of a project contain declarations of data types and functions 
that can then be used in source files. Source files contain the definitions of functions that are built by 
the compiler. Listing 7-1 shows the source code contained in a file named HelloWorld. cpp. 


Listing 7-1. HelloWorld. cpp 


#include <iostream> 
using namespace std; 


void HelloWorld() 
{ 


} 


cout << "Hello World!"; 
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This very basic example shows that we can declare functions inside code files. This file itself does 

not do anything interesting; it does not contain the entry point to our program. We would like to be 

able to call this function from other places in our code base. To be able to do this we must create a 
header file that contains a function declaration. Listing 7-2 shows our HelloWorld.h file. 


Listing 7-2. HelloWorld.h 


#pragma once 
void HelloWorld(); 


The header file is very simple and contains our function declaration. 


The #pragma once is necessary in header files to inform the compiler that we only want to include 
this file a single time. If we do not have this line at the beginning of our header file we will suffer from 
compile errors as the function definitions will occur more than once. 


Note #pragma once is a modern compiler directive that is not supported by older compilers. In the 

past, header files would have include guards instead. Include guards use #ifndef, #define, and #endif 
to wrap header files and prevent the code from being included more than once. This is less efficient than 
#pragma once, which can tell the compiler to skip opening the file and reduce compile times if it has been 
processed before. 


Now that we have a header file and a source file we will be able to use this to call our function from 
other files. Listing 7-3 shows how we can do this. 
Listing 7-3. Calling HelloWorld from_tmain 


#include "stdafx.h" 
#include "HelloWorld.h" 


int _tmain(int argc, _TCHAR* argv[]) 
HelloWorld(); 


return 0; 


} 


We can see from this example that our source files can now be kept in a much neater and more 
maintainable state. We simply include the HelloWorld.h file and we have access to the function that 
it contains. As we move forward we will be using source and header files extensively. This simple 
example covers all of the necessary details to be able to use these in our projects. 
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Creating Namespaces 


Namespaces allow us to group functionality from multiple files into a single named code unit. This 
allows us to keep our functions and data types together. It also has the added benefit of keeping our 
new type and function names out of the global namespace. Usually we can only use a function name 
a single time, so by using namespaces we can use the same function and type names in a different 
context. Listing 7-4 shows an example that creates and uses two different namespaces. 


Listing 7-4. Creating Namespaces 


#include "stdafx.h" 
#include <iostream> 


namespace Player 


{ 
void PrintName() 
{ 
std::cout << "My name is Bruce!" << endl; 
} 
} 
namespace Vehicle 
{ 
void PrintName() 
std::cout << "I am a car!" << endl; 
} 
} 


using namespace Player; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
PrintName(); 
Vehicle: :PrintName() ; 
return 0; 

} 


This example shows the creation of two different namespaces, one named Player and another 
named Vehicle. Both of these namespaces contain a function named PrintName. If these were not 
contained within a namespace they would be required to have different names. Because they are 
contained within namespaces their usage in the code must be qualified. We can qualify our use of 
items contained in namespaces in two ways. 


The first example is the Player namespace. We use the using namespace directive to inform all of the 
following code that any type and function within the namespace can be used. You can see this in the 
first line of the _tmain function, which can call PrintName directly. 
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The second example is where we call Vehicle: :PrintName. This form of qualification is more explicit. 
This is the form of qualification | would recommend in this situation where we would be calling the 
same named function from two different namespaces. The explicit qualification makes it clear which 
of the namespace functions we would like to use. 


This is also as complicated as we need namespaces to be for now. We will now rewrite the Text 
Adventure example from the previous chapter to use multiple source files and namespaces. 


Updating Text Adventure with Source Files, Header Files, 
and Namespaces 


By the end of Chapter 6 our Text Adventure game consisted of five functions, an enum class, and 

a struct. The number of these elements will only increase as we flesh out the functionality of our 
game. It would not take very long for our only source file to consist of thousands of lines of code and 
be unmanageable. 


In this section we are going to split the code we created in Listing 6-12 into separate files. We will 
also use a namespace to group our game loop functions together. We begin by taking a look at the 
Chapter7-TextAdventure. cpp file in Listing 7-5, which is included with the sample accompanying this 
chapter. 


Listing 7-5. Chapter7-TextAdventure. cpp 


#include "stdafx.h" 
#include "Player.h" 
#include "GameLoop.h" 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
Player player; 
GameLoop: :WelcomePlayer (player) ; 
bool isPlaying = true; 
while (isPlaying) 
{ 
isPlaying = GameLoop: :RunGame(); 
} 
return 0; 
} 


Our source file is now much shorter and much easier to read. The major differences to the function 
when comparing it to the version in Listing 6-12 are the uses of the GameLoop namespace qualifier on 
the WelcomePlayer and the RunGame function calls. 


You can see at the top of the file that we now include two new header files, Player.h and 
GameLoop.h. We'll take a look at Player.h in Listing 7-6. 
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Listing 7-6. Player.h 


#pragma once 
#include <string> 


struct Player 
{ 


} 


std::string m_name; 


This file is very simple. All we have here is the definition of the Player struct. This might seem like a 
waste, but | can assure you that this struct will grow in size as we build out our game. 


Listing 7-7 shows the code contained in GameLoop.h. 


Listing 7-7. GameLoop.h 


#pragma once 


#include "Player.h" 
#include "PlayerOptions.h" 


namespace GameLoop 


void WelcomePlayer(Player& player); 
void GivePlayerOptions(); 
void GetPlayerInput(std::string& playerInput) ; 
PlayerOptions EvaluateInput(std::string& playerInput) ; 
bool RunGame(); 


We have created a namespace called GameLoop to contain our functions. This will prevent any 
name clashes that might occur with functions in other files in the future. You might notice that the 
header only contains the declarations for our functions. This is an important feature, as it provides 
an optimization for the compiler and also makes the code easier to read for other programmers. 
The compiler can build source files that call functions from this header file faster when it does not 
need to read and compile the entire function declarations. Programmers can use the functions 
faster by simply looking at the parameters the function takes and the types that they return. Other 
programmers do not necessarily need to know exactly how the function operates internally. 


The actual function definitions are contained in the GameLoop. cpp file shown in Listing 7-8. 


Listing 7-8. GameLoop. cpp 


#include "GameLoop.h" 
#include <iostream> 


using namespace std; 
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eer OOO 


namespace GameLoop 


{ 
void WelcomePlayer(Player& player) 
{ 
cout << "Welcome to Text Adventure!" << endl << endl; 
cout << "What is your name?" << endl << endl; 
cin >> player.m_name; 
cout << endl << "Hello " << player.m_name << endl; 
} 
void GivePlayerOptions() 
{ 
cout << "What would you like to do? (Enter a corresponding number)" 
<< endl << endl; 
cout << "1: Quit" << endl << endl; 
} 
void GetPlayerInput(string& playerInput) 
{ 
cin >> playerInput; 
} 


PlayerOptions EvaluateInput(string& playerInput) 
PlayerOptions chosenOption = PlayerOptions: :None; 
if (playerInput.compare("1") == 0) 


cout << "You have chosen to Quit!" << endl << endl; 
chosenOption = PlayerOptions: :Quit; 


} 
else 
{ 
cout << "I do not recognize that option, try again!" 
<< endl << endl; 
} 
return chosenOption; 
} 
bool RunGame() 
{ 


bool shouldEnd = false; 


GivePlayerOptions(); 
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string playerInput; 
GetPlayerInput(playerInput); 


shouldEnd = EvaluateInput(playerInput) == PlayerOptions: :Quit; 
return !shouldEnd; 


} 


Our functions have not changed since Listing 6-12. The main difference to pay attention to is the 
namespace wrapping the function calls. Our GameLoop namespace has been extended to include the 
function definitions, if we had not done this, the compiler would complain that it could not find our 
functions when building. 


PlayerOptions.h is our last new file and is shown in Listing 7-9. 


Listing 7-9. PlayerOptions.h 


#pragma once 


enum class PlayerOptions 


{ 
Quit, 
None 


} 
This file is very simple and contains our enum class. 


Hopefully this example will give you a feel for how we use multiple source and header files to 
manage our source code. Make sure to download the sample accompanying this chapter from the 
following web site http://www. apress .com/9781430264576. 


Summary 


This chapter has introduced concepts that C++ provides to help manage large software projects. 
Video games definitely qualify as large and complex projects and productive development is only 
going to happen through the proper use of header and source files and namespaces. 


Header files allow us to create function declarations that can be included for use in multiple source 
files. This is necessary to allow the compiler to optimize its processes and to allow programmers to 
use functions without concerning themselves with the implementation details. 


Having separate source files allows us to simplify the code. Having smaller source files makes 
them more readable and also allows us to group functions with functionality that is similar to others 
into the same source files. This concept of grouping functions related to similar concepts will be 
expanded on in later in this book when we look at object-oriented programming. 
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Namespaces are another essential source code management technique. Where source files allow us 
to group similar functions into files, namespaces provide a method for communicating these types 
of groupings to the compiler. It is more common for namespaces to span multiple files and be used 
to contain the functionality needed to represent an entire module of code. Code modularity is an 
important concept that we will look at more and more as we progress. 


This chapter brings us to the end of our look at procedural programming in the C style using C++. 
The next part of the book covers object-oriented programming and specifically looks at the concept 
of classes, how they are created and used, how we inherit from classes, and how we can use 
polymorphism. 


__ 


Part 


Object-Oriented Programming 


Procedural programming can allow you to write full programs without any more features being 
required. However, C++ was built using C as its foundation, which means that you can write 
programs in different ways. 


Object-oriented programming introduces the concept of programming with objects. C++ allows you 
to create blueprints for your objects in the form of classes. Classes allow you to express the design 
of your programs in terms of collections of data contained within classes along with the operations 
that can be applied to that data. Years of research has led to best practice being applied in 
object-oriented programming, including the correct use of features such as polymorphism and 
designing programs to fully utilize encapsulation, minimize coupling, and promote cohesion. 


This part of the book introduces you to the features of C++ that enable you to use objects in your 
programs as well as lay the foundations for you to be able to design programs following best 
practices. 


__ 


Chapter 


Object-Oriented Programming 
with Classes 


The preceding part of this book covered a programming paradigm known as procedural programming. 
This part introduces the concept of object-oriented programming (OOP). Procedural programming 
was the major paradigm supported by the C programming language. The C++ programming language 
was conceived to support OOP in the same syntax as a C programming language. 


This chapter covers the major techniques behind designing OOP-based programs and then takes a 
look at the class. 


Object-Oriented Programming 


Writing computer programs in the OOP style involves thinking about our programs at a high level. 
So far you have been looking at low-level programming concepts such as deciding on which 
variables to use and how to split your program into functions. Designing OOP involves considering 
how objects will interact before deciding exactly which variables and methods will be used. You will 
usually begin writing your program with a design document. This design might be long and complex 
or short and to the point; this will depend on the requirements of the program you are working on. 
The following short paragraph covers the design of our Text Adventure game so far. 


The game begins by welcoming the user. This welcome state will ask the player to 
enter their name so that we can personalize their gameplay experience. The game 
then enters the game loop that continuously asks players to enter their input choice. 
The quit option should always be available to the player and, when selected, exits 
the program. 
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It is your job as a programmer to turn the design created by a game designer into a working 
implementation. If you were using the OOP paradigm, you would take this design and break it down 
into distinct objects in the program. We do this by looking for the nouns that exist in the design, 

as they are ideal candidates to be turned into classes. Classes form a blueprint from which you can 
create the individual objects in your program. The following nouns are present in the design and 
could be considered suitable for being turned into classes: 


Game 
User 
Player 
Name 
Game loop 


At this point you need to consider which of these really are suitable candidates for being turned 
into classes. Game seems like an obvious choice for a class, as it can be the object that represents 
the entire game. User might not be a good candidate for a class in our program. The user is the 
person interacting with our program and does not need to be represented in the program itself; 
however, a Player class would be useful to represent the current state of the players in our game. 
Name appears to be data related to the player. You’ve seen so far that we can represent strings 

in the game using the C++-supplied string class, which means we don’t have to create our own 
class for the player name. The game loop from Listing 7-7 was created using a namespace anda 
set of functions. In this chapter we look at how we can represent this using a class rather than a 
namespace to group the functionality. 


This section has given you a brief introduction to the OOP design process. The rest of this chapter 
looks at how we can build programs out of classes in C++. 


Encapsulation 


One of the main questions that comes up with programmers who are new to OOP is “Why do we 
even use classes?” There are many answers to this question, making it a complicated topic to 
explain. We cover more of the advanced features provided by classes in C++ as we work through 
this chapter. The first major benefit for the new programmer is the concept of encapsulation. Classes 
in C++ allow us to group together data in the form of variables and functions, known as methods, 
that operate on this data. The classes allow us to mark some of these variables and methods as 
being hidden from the rest of the program. 


This concept of data hiding is known as encapsulation. Encapsulation is a desirable feature of OOP 
because it allows us to operate loosely on the basis of contracts in our programs. The classes we 
write will have a public interface that other classes can expect to behave in a certain manner. This 
interface will remain consistent to allow us to create easily maintainable programs; however, the 
private data and methods can be changed as often as we need them to. This is another concept 
that can be difficult to understand, so we will work through a class listing to see how this works in 
practice. Listing 8-1 shows the code for our first class, Player. 
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Listing 8-1. The Player Class 


#pragma once 
#include <string> 


class Player 


{ 
}3 


std::string m_name; 


The Player class in Listing 8-1 might look familiar. It is almost exactly the same as the Player struct 
from Listing 7-6. All we have done is change the struct keyword to the class keyword. If you were 
to do this in our Text Adventure example from the previous chapter, the code would no longer 
compile. When you try to compile in Visual Studio you receive the following error: 


Error 1 error C2248: 'Player::m_name' : cannot access private member declared in class 'Player' 


This error occurs thanks to the encapsulation features of C++. Listing 8-2 shows why this is the case. 


Listing 8-2. class vs. struct Encapsulation 


class Player 


{ 
private: 
std::string m_name; 


B 


struct Player 


{ 
public: 
std::string m_name; 


}3 


The code in Listing 8-2 makes the distinction between a class and a struct in C++ explicit. By default all 
member variables and functions in a class are private. In a struct all members and methods are public. 


Note A traditional C style struct cannot contain any methods (member functions). However, these are 
allowed in C++, which means that the difference between a class and a struct in C++ is simply the default 
access to member variables and functions. 


The error thrown by the compiler is caused by the following line of code: 


cin >> player.m_name; 
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When using public access, this line of code is allowed, which is why our program compiled without 
errors in Chapter 7. We could fix the compile error by changing our class to code shown in Listing 8-3. 


Listing 8-3. A public Class 


class Player 


{ 
public: 
std::string m_name; 


J} 


There is a problem caused by having public member variables in C++: It breaks our encapsulation. 
We might decide later to separate the player’s first name and surname into separate strings, for 
example, and then code that relies on our Player class supplying a single name would break. The 
proper way to fix the problem is to provide accessor methods. Listing 8-4 shows the Player class 
with accessors for the name variable. 


Listing 8-4. APlayer Class with Accessors 


class Player 


{ 
private: 
std::string m_name; 
public: 
void SetName(const std::string& name) 
{ 
m name = name; 
} 
const std::string& GetName() const 
{ 
return m_name; 
} 
} 


You now have a class that respects the rules of encapsulation. The code that refused to compile 
earlier can now be fixed using the following code. 


string name; 
cin >> name; 
player .SetName(name) ; 


This section has shown why you would use classes in C++ and how to create a basic class that 
uses the benefits of encapsulation. To recap, the public specifier tells the compiler that any of the 
following member variables and methods are accessible to code outside of the class. The private 
access specifier informs the compiler that the following member variables and methods are only 
accessible from inside the class; that is, from within public or private methods that make up the 
class. The rest of this chapter looks at how we use classes properly in our code base. 
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Constructors and Destructors 


When you use the class keyword, you are actually informing the compiler to create a new type in the 
C++ language. When you create a variable of a given type in C++ the first task to be completed is 
generally initialization. C++ provides methods called constructors that are called when our classes 
are initialized. Listing 8-5 adds a constructor to our Player class. 


Listing 8-5. The Player Class Constructor 


class Player 


{ 
private: 
std::string m_name; 
public: 
Player(const std::string& name) 
: m_name(name) 
{ 
} 
void SetName(const std::string& name) 
{ 
m name = name; 
} 
const std::string& GetName() const 
{ 
return m_name; 
} 
B 


The bold code in Listing 8-5 shows the class constructor. The constructor is a special method in C++ 
classes. It does not contain a return type as it can never return a value and it also contains an initializer 
list. The initializer list is used to call the constructors on our member variables and Listing 8-5 shows 
that we have called the string class constructor on m_name before the constructor function itself is 
executed. We would use a comma if we had more variables to add to the initializer list: 


Player(const std::string& name, int anotherVariable) 
: m_name(name) 
» m_anotherVariable(anotherVariable) 

{ 

} 


If you try to execute this code after adding this constructor you will see that there is another compile 
error in the code. 


Error 1 error C2512: 'Player' : no appropriate default constructor available 
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There are several implications to this error: 


All classes must have a constructor. 


The compiler will create a default constructor if you do not specify one. This 
default constructor calls the default constructors of all member functions if they 
have them. Built-in types such as int do not have default constructors and are 
therefore uninitialized. Default constructors do not take any parameters. 


The compiler will not generate a default constructor if you specify a constructor. 


Our class no longer has a default constructor once we specified the constructor that takes the 
string parameter, which means that we cannot create a class without passing a string to player. 
The following line is the offending code: 


Player player; 

You can fix this in two ways, either by passing a string parameter: 

Player player("defaultName") ; 

or by adding your own default constructor to the Player class, as shown in Listing 8-6. 


Listing 8-6. Adding a Default Constructor to Player 


class Player 


{ 
private: 
std::string m_name; 


public: 
Player() 
{ 


} 


Player(const std::string& name) 
: m_name(name) 


{ 
} 
void SetName(const std::string& name) 
{ 
m name = name; 
const std::string& GetName() const 
{ 
return m_name; 
} 


}3 
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Whether you add default constructors to your classes will depend on whether it is valid to do so. 
Not all classes make sense when they are not passed values to initialize them. Class constructors 
are called when objects of our class type are being created; class destructors are called when our 
objects are being destroyed. Objects can be destroyed in a number of ways, but our code currently 
only destroys objects when they are going out of scope. Listing 8-7 shows an example. 


Listing 8-7. Going out of Scope 
int _tmain(int argc, _TCHAR* argv[]) 


{ 
Player player; 
GameLoop: :WelcomePlayer(player) ; 
bool isPlaying = true; 
while (isPlaying) 
{ 
isPlaying = GameLoop: :RunGame() ; 
ji 
return 0; 
} 


The Player constructor is called when the player variable is created. This code is calling the default 
constructor. The player variable goes out of scope once the function that contains it returns. This 
means that the destructor is called automatically after the return call is executed. Listing 8-8 shows 
the Player class with a destructor added. 


Listing 8-8. The Player Class destructor 


class Player 


{ 
private: 
std::string m_name; 


public: 
Player() 


} 


Player(const std::string& name) 
: m_name(name) 
{ 


} 
~Player() 


} 


void SetName(const std::string& name) 


{ 
} 


m_name = name; 
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const std::string& GetName() const 


{ 
} 


return m_name; 
}; 


The destructor function also doesn’t specify a return type and does not return a value. The 
destructor is created by having a function that is named the same as the class itself but with a 
~ prepended. All classes have destructor methods but again, the compiler will create a default 
destructor if we do not. You do not have any code to put into your destructor at the moment; 
however, we will look at how they can be used to greater effect in later chapters. 


Note When we are talking about the code that makes up a class we are talking about classes. When we talk 
about variables that are of a class type, we refer to them as objects. That means the class is the type, and an 
object is an instance of the class. 


This section has shown you how to specify the methods that are called when objects are created 
and destroyed. The rest of this chapter covers some more advanced features that will be useful as 
we move through the rest of the book. 


Method Overloading 


C++ allows you to overload methods. This actually means that you can create methods of the same 
name but that take different input parameters. You can see an example of this in Listing 8-9. 


Listing 8-9. Overloading Player: : SetName 


class Player 


{ 
private: 
std::string m_name; 


public: 
Player() 
{ 


} 


Player(const std::string& name) 
: m_name(name) 
{ 


~Player() 
{ 


} 
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void SetName(const std::string& forename, const std::string& surname) 


{ 
m_name = forename; 
m_name.append(" "); 
m_name.append(surname) ; 
} 


void SetName(const std::string& name) 


m_name = name; 


} 
const std::string& GetName() const 
{ 
return m_name; 
} 


i 


Your Player class now contains two methods called SetName. You can call either of these methods 
using the following lines: 


player.SetName("Bruce Sutherland"); 
player.SetName("Bruce", "Sutherland"); 


The compiler automatically works out which of the two methods to call based on the parameters 
being passed in. The first line here would call the method that simply assigns the string to m_name; 
the second line would call the function that assigns the first name then appends a space before 
appending the surname. Both functions result in m_name storing the same string value. 


Methods can only be overloaded by having different parameter types. Methods with different names 
are not overloaded, but the code will still compile. Methods that only have different return types are 
not allowed. Listing 8-10 shows an example of this. 


Listing 8-10. SetName with Different Return Types 


void SetName(const std::string& name) 


' m_name = name; 
} 
bool SetName(const std::string& name) 
{ 
m name = name; 
return true; 
} 


If you try this in Visual Studio, you will see the following error: 


error C2556: ‘bool Player::SetName(const std::string &)' : overloaded function differs only by 
return type from 'void Player::SetName(const std::string &)' 
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Methods aren’t the only things that C++ allows us to overload. We can also overload operators, 
which allows us to use our classes like the built-in types. 


Operator Overloading 


Listing 8-11 shows our player class with an overloaded += operator. 


Listing 8-11. Overloading Player's += Operator 


class Player 


{ 


private: 


public: 


}3 


std::string m_name; 


Player() 
{ 
} 


Player(const std::string& name) 
: m_name(name) 


{ 
} 
~Player() 
} 
void SetName(const std::string& forename, const std::string surname) 
{ 
m_name = forename; 
m name.append(" "); 
m_name.append(surname) ; 
} 
void SetName(const std::string& name) 
{ 
m name = name; 
} 
void operator+=(const std::string& name) 
{ 
m_name.append(name) ; 
} 
const std::string& GetName() const 
{ 
return m_name; 
} 
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Our += operator is an assignment operator, which means we want to use it to modify our object. 
You can see this in our operator method where we append the name string onto the object’s m_name 
member variable. We can use this in the following manner: 


player.SetName("Bruce") ; 
player += " Sutherland"; 


Sometimes you might not want to modify the object, but instead would like to add the name to the 
passed string and store a returned value. It might make more sense to overload the + operator in this 
instance. Listing 8-12 shows an example of this. 

Listing 8-12. The Overloaded + Operator 


std::string operator+(const std::string& name) 


{ 
std::string output(m_name) ; 
output .append(name) ; 
return output; 

} 


This function appends the passed string parameter to the m_name member and returns the new string 
that was created to store the result. We can use this operator in the following way. 


player.SetName("Bruce") ; 
string fullName = player + " Sutherland"; 


These examples are not the most useful and are being created just to show you how you can 
incorporate operator overloading into your future classes. There’s also a drawback to the examples 
we have looked at: We cannot chain the operators together. Listing 8-13 shows an assignment 
operator that allows chaining. 


Listing 8-13. Operator Chaining 


const Player& operator=(const Player& player) 
{ 


m_name = player.name; 
return *this; 


} 


The major new keyword being used in this example is this. The this pointer is a built-in keyword 
that C++ supplies. It is a pointer that stores the address of the current object. Our = operator returns 
a constant reference to the current Player object. Listing 8-14 alters our WelcomePlayer method to 
show how this allows operator chaining in practice. 


Listing 8-14. Operator Chaining 


void WelcomePlayer(Player& player) 
{ 


cout << "Welcome to Text Adventure!" << endl << endl; 
cout << "What is your name?" << endl << endl; 
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string name; 

cin >> name; 

player.SetName("Bruce") ; 

Player player1, player2, player3, player4; 
player1 = player2 = player3 = player4 = player; 


cout << endl << "Hello " << player.GetName() << endl; 


} 


Operator chaining has allowed us to assign the value from player to all of the temporary Player 
objects we have created. You can think of these statements being operated in the following order. 


player4 = player; 
player3 = player4; 
player2 = player3; 
player1 = player2; 


Chaining makes sense for the assignment operator; however it might not make a lot of sense in 
other areas. You will see examples of practical uses for operator overloading and chaining as 
we move through the remaining chapters of the book. 


Updating Text Adventure to Use Classes 


Now that you have a grasp of what classes are and how they can be used, we will update the Text 
Adventure game to be based around the principles of OOP. The first change you will make will be to 
remove the GameLoop namespace and create a Game class. Listing 8-15 shows this new Game class. 


Listing 8-15. The Game Class 


class Game 
{ 
private: 
Player m_player; 


void WelcomePlayer(); 

void GivePlayerOptions(); 

void GetPlayerInput(std::string& playerInput) ; 
PlayerOptions EvaluateInput(std::string& playerInput) ; 


public: 
void RunGame() ; 


}5 


Our Game class contains a private member variable representing our player and private methods to 
update the game state. These methods are listed in the corresponding source file shown in 
Listing 8-16. 
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Listing 8-16. Game.cpp 


#include "Game.h" 
#include <iostream> 


using namespace std; 


void Game: :WelcomePlayer() 


{ 
cout << "Welcome to Text Adventure!" << endl << endl; 
cout << "What is your name?" << endl << endl; 
string name; 
cin >> name; 
m_player.SetName(name) ; 
cout << endl << "Hello " << m_player.GetName() << endl; 
} 
void Game: :GivePlayerOptions() 
{ 
cout << "What would you like to do? (Enter a corresponding number)" 
<< endl << endl; 
cout << "1: Quit" << endl << endl; 
} 
void Game: :GetPlayerInput(string& playerInput) 
{ 
cin >> playerInput; 
} 


PlayerOptions Game: :EvaluateInput(string& playerInput) 
PlayerOptions chosenOption = PlayerOptions: :None; 
if (playerInput.compare("1") == 0) 
{ 


cout << "You have chosen to Quit!" << endl << endl; 
chosenOption = PlayerOptions: :Quit; 


else 


cout << "I do not recognize that option, try again!" << endl << endl; 


return chosenOption; 
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void Game: :RunGame() 


{ 
WelcomePlayer(); 
bool shouldEnd = false; 
while (shouldEnd == false) 
{ 
GivePlayerOptions(); 
string playerInput; 
GetPlayerInput (playerInput) ; 
shouldEnd = EvaluateInput(playerInput) == PlayerOptions: :Quit; 
} 
} 


The examples so far in this chapter had all defined the class methods inside the class declaration. 
Our Game class now declares the methods in the header file and creates the declarations in a source 
file. You can see how we achieve this by prepending the class name to the method name like this: 


void Game: :WelcomePlayer() 


Another change made to the methods when comparing them to the functions in Chapter 7 is that 
they can now access the m_player object as a member variable rather than requiring that it be 
passed into the methods. You can also see that we have moved our entire game loop into the 
RunGame method. This is the change that has allowed you to make all of the other methods that make 
up the Game class private. This is a good example of encapsulation, as any other code that now uses 
the Game class can only ask it to run. All of its implementation details have been hidden behind its 
public interface. 


We have been altering our Player class as we moved through this chapter, and the final result is 
shown in Listing 8-17. 


Listing 8-17. The Player Class 


class Player 


{ 
private: 
std::string m_name; 
public: 
void SetName(const std::string& name) 
{ 
m name = name; 
} 
const std::string& GetName() const 
{ 
return m_name; 
} 


J 
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Our Player class has gone back to being very basic. At the moment, the default constructor and 
destructor do everything we need for the class and the overloaded methods and operators that we 
looked at in this chapter were purely instructional and actually don’t make much sense for the player 
object. The player object will still grow over time; however, for now, storing the user’s name is all we 
need it to do. 


The last changes that you need to make to the code from Chapter 7 involve the main function. 
The new main function is shown in Listing 8-18. 


Listing 8-18. The main Function 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
Game game; 
game.RunGame() ; 
return 0; 

} 


main is now very basic. It creates an instance of the Game class and then calls the only public method 
that is exposed, RunGame. The player object is now a private member of Game, as are the functions 
we had created to make the game loop more readable. We can now refer to those variables and 
members generally as the implementation details of the class, and RunGame is part of the Game class’s 
public interface. 


Summary 


This chapter has introduced you to the class concept of C++. Classes were the first feature that set 
C++ apart from the C programming language. Adding classes to C allowed a new way of thinking 
about computer programming to be used in C-style programs, object-oriented programming. In this 
chapter you looked at how you can think about OOP from a high level and how you can turn a basic 
design into a class design for a program by finding the nouns. 


You then learned how to use classes effectively in C++ by creating them in a manner that helps 
encourage encapsulation in your programming. You learned that by hiding data and methods inside 
classes it is possible to create code that is more easily maintainable in the future. This is possible 
because the details of how a class is implemented can be changed so long as the public methods 
remain consistent and carry out their intended operations. 


You’ve seen that classes are essentially a way for you to add your own user-defined types to the 
C++ language and that C++ also provides features such as method and operator overloading to 
make those types blend in with others. These features make writing code with classes simpler for 
other programmers, but they rely on you to ensure that the operations that overloaded methods and 
operators perform are consistent with how they have been used in other places in the C++ language. 


The next chapter is going to shed some more light on some of the keywords that help make classes 
more secure, make them faster, and to allow them to share data. We have already seen examples of 
the const keyword and you’ve already created some implicitly inline methods without even realizing 
it. The next chapter will make these concepts clearer. 


__ 


Chapter 


Controlling Data with Access 
Modifiers 


C++ allows you to control how data in variables can be accessed by using different access 
modifiers. There are modifiers that tell the compiler that a variable should be shared among 
classes or that the program cannot change the value of the variable after it has been initialized. 
Unfortunately some of the keywords supplied by C++ are reused and mean different things in 
different circumstances. l'Il cover the use of the static, const, mutable, and friend keywords in 
C++, and their multiple uses in this chapter. 


The static Keyword 


The static keyword has four major uses in C++ programs: 


It is used within functions to indicate that a variable should remember its value 
each time the function is called. 


It is used within classes to tell the compiler that each object created from the 
class should share the same variable. 


It is used within classes to tell the compiler that a method can be called without 
having an object instance. 


It is used to tell the compiler that a variable declared outside of a class or 
function should have file scope rather than global scope. 


These completely different uses for the static keyword make it difficult to master or even just 
to remember which effect the word will have when you use it in your code. The following section 
provides examples of each case to help you understand how static behaves in everyday usage. 


97 


98 CHAPTER 9: Controlling Data with Access Modifiers 


Creating static Local Variables 


The static local variable is the simplest version of static to understand. A normal local variable 
will lose its value each time a function returns and will reset to the initialized value the next time the 
function is called. Listing 9-1 shows an example of a normal local variable in action. 


Listing 9-1. A Normal Local Variable 


void NormalLocalVariable() 


{ 
int x = 0; 
std::cout << x++ << std::endl; 


} 


With the function source in Listing 9-1 the console will have the value 0 added every time we call the 
function NormalLocalVariable. This is because the variable is re-created each time the function is 
called. Listing 9-2 shows the code for a static local variable. 


Listing 9-2. A static Local Variable 


void StaticLocalVariable() 
{ 


static int x = 0; 
std::cout << x++ << std::endl; 


} 


This time you have told the compiler that you would like the variable x to be static. When you do 
this, the compiler creates a variable in a location in memory that prevents it from being overwritten 
each time the function is called (you will learn more about C++ memory management in Chapter 
26). The effect of this is that the value stored in the variable is preserved and will increase with each 
call. The non-static variable in Listing 9-1 always contained 0 when it was printed out, whereas the 
variable in Listing 9-2 will print O on the first call, 1 on the second call, and so on. 


The use of static local variables is a practice | wouldn’t recommend for normal code as it 
encourages you to take shortcuts in the design of your code. These shortcuts almost always cause 
you more difficult problems in the longer term. You’ll see how private member variables can be used 
instead when we cover classes. It can be useful to use static variables to count the number of 
times a function has been called or to time how long the execution of those function calls takes, but 
static local variables are rarely the best design choice for standard game code. 


Using static class Member Variables 


The static keyword can also be used with class member variables. Listing 9-3 shows an example 
class that contains a static member variable. 


CHAPTER 9: Controlling Data with Access Modifiers 99 
Listing 9-3. A static Member Variable 


class StaticCounter 


{ 
private: 
static int m counter; 
public: 
void IncrementCounter() 
{ 
++m_counter ; 
} 
void Print() 
{ 
std::cout << m_counter << std::endl; 
} 
}; 


int StaticCounter::m_counter = 0; 


Using the static keyword on a member variable has a similar effect as using it on a local variable. 
The variable will be created in static memory rather than within the memory space for the object 
itself. You should pay special attention to the final line of this listing. Member variables that we 
declare to be static must be defined and this usually occurs in the source file that accompanies 

a header file for the class. A clear example of this is shown in the source code sample that 
accompanies this chapter and can be downloaded from this book’s accompanying web site: 
http://www. apress .com/9781430264576. This causes all objects created from this class type to share 
the same static variable, which in Listing 9-4 is the m_counter variable. The source code in Listing 
9-4 shows how we can call these functions. 


Listing 9-4. Using the StaticCounter Class 


StaticCounter counter1; 
counter1.Print(); 
counter1.IncrementCounter(); 
counter1.Print(); 


StaticCounter counter2; 
counter2.Print(); 
counter2.IncrementCounter(); 
counter2.Print(); 


These lines of code in a program would output 0, 1, 1, then 2. This happens because both counter1 
and counter2 are sharing the same m_counter variable. Another way you could see this in action 
would be to look at the address of the m_counter variable. Listing 9-5 shows how you can do this. 


Listing 9-5. Getting the Address ofm_counter 


void Print() 

{ 
std::cout << m_counter << std::endl; 
int* address = &m_ counter; 
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If you were to run this code in your debugger you would be able to set a breakpoint on the line 
containing the closing brace for the function block. Your debugger should have two variables shown 
in the local variables window. Figure 9-1 shows the local variable window from a Visual Studio 
integrated development environment (IDE). 


Locals 


Name Value Type 
@ this Ox00fcfad3 {...} StaticCo 
> @ address Ox00b6f680 {Chapter9-StaticLocal.exelint StaticCounter::m_counter} {0} int * 


Locals BVEA] 


Figure 9-1. The counter1 this address 


Figure 9-1 shows the state of the debugger when execution stops in the Print method that has been 
called on the counter1 object. You can see that the address of counter1 is stored in the this pointer 
and is 0x00fcfad3. The address variable that stores the address of m_counter holds the address 
0x00b6f680. Figure 9-2 shows the same variables when Print is called on the counter2 object. 


Locals ~ ax 
Name Value Type 
@ this Ox00fcfac7 {...} StaticCo 
b @ address Ox00b6f680 {Chapter9-StaticLocal.exelint StaticCounter::m_counter} {1} int * 


Locals SVEA] 


Figure 9-2. The counter2 this address 


You can see in Figure 9-2 that the value stored in this has changed. The Visual Studio debugger has 
helpfully displayed the value in red to show that the value has changed. Both values in Figure 9-1 

are red as they were both new values that were being shown. The address of counter2 is now stored 
in the this pointer and is oxoofcfac7. Despite the change in the object address, the address of m_ 
counter has stayed exactly the same and is a direct result of using the static keyword on the member 
variable of the StaticCounter class. Every instance of the StaticCounter class would now use the 
exact same m_counter variable and any change to this variable will be shared. 
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Using static Member Methods 


Listing 9-3 contained the IncrementCounter method, which we called on the counter1 and counter2 
objects in Listing 9-5. This method was a standard method that relied on an existing object to 

be usable. C++ also allows us to create static member methods that do not rely on an object to 
be callable. Listing 9-6 shows an updated version of the StaticCounter class that uses a static 
member method. 


Listing 9-6. Using a static Member Method 


class StaticCounterMethod 


{ 
private: 
static int m counter; 
public: 
static void IncrementCounter() 
{ 
++m_counter; 
} 
static void Print() 
{ 
std::cout << m_counter << std::endl; 
int* address = &m_counter; 
} 
}; 


int StaticCounterMethod::m_counter = 0; 


You can see in Listing 9-6 that the only changes that we make to turn our methods into static 
methods is to add the static keyword at the beginning of their method signature. Listing 9-7 shows 
how you can use these static methods. 


Listing 9-7. Using static Methods 


StaticCounterMethod: :Print(); 
StaticCounterMethod: : IncrementCounter(); 
StaticCounterMethod: :Print(); 


StaticCounterMethod: :Print(); 
StaticCounterMethod: : IncrementCounter(); 
StaticCounterMethod: :Print(); 


You can see in Listing 9-7 that we can now call these static methods in a different way than 
non-static methods. First you use the name of the class, which is followed by the scope resolution 
operator (::) and the name of the static function we would like to call. You have already used 

the scope resolution operator when accessing variable and function names that exist inside of 
namespaces. In this instance we are simply letting the compiler know that we’d like to access the 
global variables or methods that are contained within the class. 
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Using static to Alter Global Scope 


The last use of the static keyword allows you to tell the compiler that you would like a variable to 
exist within the scope of a single file rather than in the global scope. Global variables are generally 
frowned on as they break encapsulation in object-oriented programs and we won’t be using any in 
our Text Adventure game that hold game data. You might come across these in production code, 
though, so it’s good to know how to work with them. Listing 9-8 shows an example of a globally 
scoped and a file scoped variable. 


Listing 9-8. Globally Scoped and File Scoped Variables 


#include "stdafx.h" 
#include <iostream> 
#include "extern.h" 


int globalVariable = 0; 
static int fileVariable = 0; 


int _tmain(int argc, _TCHAR* argv[]) 


{ 
IncrementGlobalCounters(); 
std::cout << globalVariable << std::endl; 
return 0; 

} 


Listing 9-8 defines a global variable named globalVariable and a file variable named fileVariable. 
The declaration of the function IncrementGlobalCounters is contained in the extern.h header file. 
Listing 9-9 shows the contents of this basic file. 


Listing 9-9. extern.h 


#pragma once 
void IncrementGlobalCounters(); 
The function definition is in extern.cpp, shown in Listing 9-10. 


Listing 9-10. extern.cpp 


#include "extern.h" 


void IncrementGlobalCounters() 

{ 
extern int globalVariable; 
++globalVariable; 


// Error - will not compile as fileVariable is not global! 
extern int fileVariable; 
++fileVariable; 
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Listing 9-10 introduces the extern keyword. You use extern to tell the compiler that it can search the 
global scope for a variable of this name. In this case the variable will be found in the file containing 
_tmain. Trying to use extern with fileVariable will cause an unresolved external symbol error when 
you try to build. The variable is unresolved because fileVariable has been declared as static, 
which means that it can only be used from within the file where it was declared. 


This use of static to limit variables to file scope is deprecated. That means it is still supported but 
no longer the recommended method for achieving file scoped variables. A more modern approach 
is to use an anonymous namespace. Listing 9-11 alters Listing 9-8 to use an anonymous namespace 
instead of a static variable. 

Listing 9-11. Anonymous namespaces 


#include "stdafx.h" 
#include <iostream> 
#include "extern.h" 
int globalVariable = 0; 


namespace 


int fileVariable = 0; 


} 

int _tmain(int argc, _TCHAR* argv[]) 

{ 
IncrementGlobalCounters(); 
std::cout << globalVariable << std::endl; 
return 0; 

} 


The anonymous namespace is simply a namespace that is not given a name. Any of the variables, 
functions, or classes that you include inside the namespace will be accessible inside the file that 
contains the anonymous namespace. 


This section should have given you an idea of just how overloaded the static keyword is. The next 
section covers the const keyword, which is not quite as overloaded but still confusing. 


The const Keyword 


A constant in C++ is a variable that cannot be changed. Constants are useful to store values that 
you know at compile time, for passing values into methods that you don’t want to be able to change, 
and for marking methods in classes that should not be allowed to change member variables. lII 
cover these uses in the following sections. 
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Constant Variables 


Constant variables are used to avoid having magic numbers in our code and to generally represent 
values that we know at compile time and will never change during execution. Classic examples in 
game programming are constant values used to represent pi or the values used to convert angles in 
degrees to angles in radians and vice versa. Listing 9-12 shows how we can create some constant 
variables to reference in our code. 


Listing 9-12. Example Constant Variables 


#include "stdafx.h" 
#include <iostream> 
#include "extern.h" 


int globalVariable = 0; 


namespace 
{ 
const unsigned int MAX_LOOPS = 10; 
} 
int _tmain(int argc, _TCHAR* argv[]) 
{ 
for (unsigned int i = 0; i < MAX_LOOPS; ++i) 
{ 
IncrementGlobalCounters(); 
std::cout << globalVariable << std::endl; 
} 
} 


We have added a const unsigned int variable named MAX_LOOPS to our code from Listing 9-11. The 
benefit of using a constant is that if you use the same variable in multiple places, you would only 
have to change the value in a single place to ensure that the value is changed everywhere it is used. 
You can see this benefit in Listing 9-13. 


Listing 9-13. Using a const Variable in Multiple Places 


unsigned int arrayOfValues[MAX_LOOPS]; 
for (unsigned int i = 0; i < MAX_LOOPS; ++i) 


{ 
arrayOfValues[i] = i; 
IncrementGlobalCounters(); 
std::cout << globalVariable << std::endl; 
std::cout << fileVariable << std::endl; 

} 


If you fail to use a constant variable and instead use the value 10 in the array definition and in the 
loop, you run the risk of introducing bugs. If the array was reduced to contain 5 elements and the 
loop remained at 10 then the loop would overrun the end of the array and overwrite memory used to 
store values in other variables. 
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Constant Pointers 


Pointers can also be made to be constant; however, the logic is a little more involved. Listing 9-14 
shows the different types of pointer constant that we can create. 


Listing 9-14. Three Types of Constant Pointer 


const char* const NAME = "Bruce Sutherland"; 
const char* BOOK = "Learn C++ Game Development"; 
char* const YEAR = "2014"; 


The first example shows the type const char* const. When dealing with constant pointers we read 
the type keywords from right to left so this first example gives us a constant pointer to a character 
constant. In practice this means that you cannot change the address to which the pointer points or 
the data that it points at. 


The second example is a pointer to a character constant. You cannot change the text data but you 
can change the address pointed to, so adding the following line would be valid. 


BOOK = NAME; 


This would result in both BOOK and NAME pointing to the string "Bruce Sutherland". 


The remaining example is a constant pointer to character data. You can’t change the pointer but you 
can change the data pointer to it, so you can do the following. 


YEAR[O] = '3'; 


The array operator would not have compiled if it was used on either NAME or BOOK, as the character 
data was constant. 


Constant Parameters 


It is a straightforward task to make parameters constant. Listing 9-15 shows a function with constant 
parameters. 


Listing 9-15. Constant Parameters 


bool ConstParams(const int numLetters, const char* const stringData) 


{ 
} 


return strlen(stringData) == numLetters; 


This example uses a C-style string just for the purposes of the example. As you can see, we can 
pass constant built-in types or constant pointers to functions or class member methods. 


Constant Member Methods 


This last section on constants will show you how to create constant member methods. Listing 9-16 
shows an example. 


106 CHAPTER 9: Controlling Data with Access Modifiers 


—e—e— O 


Listing 9-16. A const Member Method 


class ConstantExample 


private: 
int m_counter; 


public: 
ConstantExample() : m_counter(0) {} 
int GetCounter() const { return m counter; } 
void IncrementCounter() { ++m counter; } 


}3 


You can create a const method by adding const to the end of the method signature. The implication 
of this goes hand in hand with const variables. Listing 9-17 gives an example. 


Listing 9-17. A const Reference 


ConstantExample example; 

const ConstantExample& constRefExample = example; 
constRefExample. IncrementCounter(); 
constRefExample.GetCounter(); 


If you try to compile the code in Listing 9-17 you will receive an error. We cannot call 
IncrementCounter using the const reference, as it is not a constant member method. You also 
cannot call non-const members on constant pointers or on constant variables. 


You will receive a compile error if you try to alter any member variables in const member methods. 
Listing 9-18 shows how we can use the mutable keyword to tell the compiler that a member variable 
can be changed in const member methods. 


Listing 9-18. The mutable Keyword 


class ConstantExample 


{ 
private: 
int m_counter; 
mutable int m_countGets; 
public: 
ConstantExample() : m_counter(0), m_countGets(0) {} 
int GetCounter() const { ++m_countGets; return m counter; } 
void IncrementCounter() { ++m counter; } 
J; 


Listing 9-18 shows a good example of the mutable keyword. It is best used sparingly and usually 
for debug information as the keyword technically goes against the normal usage of const member 
methods. The code in Listing 9-18 allows us to count how many times the GetCounter method is 
called even though is it a const member method and shouldn’t be able to change any member 
values. 
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Two More Keywords 


Whereas static and const have several uses and will be common in your code, there are another 
two keywords that make an appearance in C++ but don’t have such obvious effects. The first is the 
inline keyword and the second is the friend keyword. 


The inline Keyword 


At different times in your programming journey you will have to consider different goals. Sometimes 
you will need to write code that executes as quickly as possible and at others you will have to write 
code that uses as little memory as possible. The inline keyword and inline member methods allow 
us to ask the compiler to help us with this. 


When you inline a method the compiler will skip the instructions it needs to call the method; 
instead, the function body will be duplicated every time you call the method. This duplication of 
instructions reduces the length of time it takes to call the method, but increases the amount of 
memory used by duplicating the method throughout the code. For methods that are called many 
times, this duplication could be significant. Listing 9-18 contained two functions, GetCounter and 
IncrementCounter. 


The compiler will attempt to inline these methods because the definitions are contained within 
the class definition. You could achieve the same thing explicitly by making the changes shown in 
Listing 9-19. 

Listing 9-19. The inline Keyword 


class ConstantExample 


{ 
private: 
int m_counter; 
mutable int m_countGets; 
public: 
ConstantExample() : m_counter(0), m_countGets(0) {} 
int GetCounter() const; 
void IncrementCounter() ; 
3 
inline int ConstantExample: :GetCounter() const 
{ 
++m_countGets ; 
return m_counter; 
} 


inline void ConstantExample: : IncrementCounter() 


{ 
} 


++m_counter; 
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You might find that your code is more readable if you move the method definitions out of the body of 
the class. This is where the inline keyword helps. Now that you know how to make inline methods 
you might be wondering why you would do this. Each time we call a function or method, the 
compiler inserts code to set up the parameters, handle the return value, and ensure that the code 
can carry on where it left off when the method returns. For simple methods this plumbing code can 
take more time than the code contained in the method. You can use inline to avoid the cost of this 
setup code. Compare the code in Listings 9-20 and 9-21. 


Listing 9-20. A Non-inline Method 


ConstantExample example; 
const ConstantExample& constRefExample = example; 


int count = constRefExample.GetCounter(); 


Listing 9-21. The Result of Using inline 
ConstantExample example; 


const ConstantExample& constRefExample = example; 


++constRefExample.m countGets; 
int count = constRefExample.m_ counter; 


Listing 9-21 shows how the code would look if we had public access to the member variables of 
constRefExample. This is how the compiler would write your code if you define GetCounter as an 
inline method. 


Note The inline keyword is just a compiler hint. The compiler can choose to ignore the keyword or it 
can inline functions that do not have the keyword. This is especially true for inline methods that call other 
methods or functions. 


The friend Keyword 


The friend keyword allows us to write classes that can access the private member variables and 
methods of another class. You can see this in action in Listing 9-22. 


Listing 9-22. The friend Keyword 


class ConstantExample 


{ 


friend class ConstantExampleFriend; 
private: 
int m_counter; 


mutable int m_countGets; 


int GetCounter() const; 
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public: 
ConstantExample() : m_counter(0), m_countGets(0) {} 
void IncrementCounter(); 


}; 
inline int ConstantExample: :GetCounter() const 
{ 
++m_countGets; 
return m_counter; 
} 
inline void ConstantExample: : IncrementCounter() 
{ 
++m_counter; 
} 
class ConstantExampleFriend 
{ 
public: 
int GetCounter(const ConstantExample& constantExample) 
{ 
return constantExample.GetCounter(); 
} 
}; 


The ConstantExample: :GetCounter method is private in Listing 9-22. This means that we would not 
be able to access this method from an object of this type. | have added a line to ConstantExample to 
inform the compiler that ConstantExampleFriend is a friend class of ConstantExample. Listing 9-23 
shows how we can use this class to access the private ConstantExample: :GetCounter method. 


Listing 9-23. Using a friend class 


ConstantExample example; 
ConstantExampleFriend exampleFriend; 
int count = exampleFriend.GetCounter(example) ; 


Listing 9-23 shows that the count value contained in example can be accessed via an instance of 
ConstantExampleFriend. 


Summary 


This chapter has covered a few utility keywords in the C++ language. The static, const, extern, 
inline, and friend keywords allow you to control how variables are accessed and more important 
allow you to communicate the intent of your code more clearly. Data that is to be shared and remain 
consistent across multiple function calls can be made static. Variables that are never meant to be 
changed can be marked as const. 


The concepts that were introduced in this chapter can take some time to become second nature. 
You will see several examples of inline and friend as we go through this book. | would recommend 
that you avoid using inline, friend, and extern until you are more confident in your programming. 
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A good modern compiler will inline functions that it believes will benefit from the performance 
boost automatically and the other two keywords can be a sign of code that might be better written 
in a different way. The extern keyword is particularly rare in modern code as it generally goes 
against the aim of object-oriented code to keep data and implementations behind interfaces using 
encapsulation. 


The next chapter will introduce you to inheritance. Inheritance allows us to create hierarchies of 
classes and is particularly important for game development. The Text Adventure game you are 
developing will become much more interesting in the next chapter as you create rooms, items, and 
commands that allow a player to interact with the game world. 


Chapter 1 O 


Building Games with Inheritance 


Being a productive video game developer involves writing well-organized code that can be reused 
as often as possible. C++ classes provide a feature named inheritance that helps us achieve both 
of these goals. Inheritance allows us to create generalized base classes that can be derived from to 
create classes with a more specific purpose. In this chapter you learn how this allows us to share 
behavior among classes. 


Inheriting from a Base Class 


The classic example used to explain inheritance to new programmers is that of motor vehicles. There 
are multiple categories of vehicles, including cars, motorbikes, and trucks. All of these things can be 
thought of as vehicles and therefore can be included in a vehicle category. All have common features 
such as wheels, engines, and lights but all are obviously very different. If we were to make a game 
that included vehicles we could easily represent these in a class hierarchy. Figure 10-1 shows how 


we can visualize our class structure. 
Vehicle 
Motorbike 


The simple diagram in Figure 10-1 shows that we will have a base class named Vehicle and that 
there will be three derived classes, one named Car, one named Motorbike, and one named Truck. 
Listing 10-1 shows the code for the Vehicle class. 


Figure 10-1. The vehicle class hierarchy 
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Listing 10-1. The Vehicle Class 


class Vehicle 


{ 
private: 
unsigned int m_numberOfwheels ; 


public: 
Vehicle(); 


unsigned int GetNumberOfWheels() const; 
} 


Vehicle: :Vehicle() 
: m_numberOfWheels(0) 


{ 

} 

unsigned int Vehicle: :GetNumberOfWheels() const 
return m_numberOfWheels; 


The Vehicle class contains a private variable that stores the number of wheels the vehicle has. 
The variable is private and the Vehicle class does not provide a method to set it. Instead, classes 
that derive from Vehicle will set their own number of wheels in their own constructor. 


Note The constructor for the Vehicle class uses an initializer list to initialize its variables. An initializer list 
ensures that the variables’ values are set before any of the code contained within the constructor is executed 
and is the preferred method for initializing class member variables. You can use an initializer list in your class 
constructors by following the constructor signature with a colon and placing the value to initialize within 
brackets. Subsequent variables can be added to the list using commas. 


Listing 10-2 shows the class definition for a Car. 
Listing 10-2. The Car Class 
class Car : public Vehicle 


public: 
Car(); 


; 
Car: :Car() 


m_numberOfWheels = 4; 
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The Car class is inheriting from Vehicle using public inheritance. You can inherit one class from 
another by following the class name with a colon, followed by public then the name of the class you 
wish to derive from. Listing 10-2 shows that we have derived Car from Vehicle. 


If you enter the code from Listing 10-2 into your integrated development environment (IDE) and try to 
compile you will be given a compiler error. The compiler cannot access m_numberOfWheels in the Car 
constructor as it is a private member of Vehicle. One option would be to make m_numberOfWheels a 
public variable; however, this would break our encapsulation and allow the variable to be accessed 
from anywhere in our code. A better option is to use the protected keyword. Listing 10-3 updates 
the Vehicle class with the protected keyword. 


Listing 10-3. Using protected in Vehicle 


class Vehicle 


protected: 
unsigned int m_numberOfwWheels ; 


public: 
Vehicle(); 


unsigned int GetNumberOfWheels() const; 
}; 


The protected keyword makes variables behave as though they are private to outside code; that is, 
they still cannot be accessed directly by calling code. The key difference to private member variables 
is that they can be accessed by derived classes. By declaring m_numberOfWheels as protected in the 
Car class we can now access it directly in Car and set the number of wheels to 4. Listing 10-4 shows 
some code to print the number of wheels each vehicle type contains. 


Listing 10-4. Printing the Number of Wheels 


void PrintNumberOfwWheels() 


{ 
Vehicle vehicle; 
Car car; 
std::cout << vehicle.GetNumberOfWheels() << std::endl; 
std::cout << car.GetNumberOfWheels() << std::endl; 


This function will result in O being printed followed by the number 4. It’s important that you 

note what this function has achieved. The Car class defined in Listing 10-2 does not contain a 
GetNumber0fWheels method, nor does it have a variable to store a number of wheels. The Car class 
has inherited these from the Vehicle class. Listing 10-5 shows how you can inherit another class 
from Vehicle, this time Motorcycle. 
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Listing 10-5. The Motorcycle Class 


class Motorcycle : public Vehicle 


{ 
public: 
Motorcycle(); 
}; 
Motorcycle: :Motorcycle() 
{ 
m_numberOfWheels = 2; 
} 


You can see that we add our new class to PrintNumberOfWheels in Listing 10-6. 


Listing 10-6. Adding Motorcycle to PrintNumberOfwheels 


void PrintNumberOfwWheels() 


Vehicle vehicle; 

Car car; 

Motorcycle motorcycle; 

std::cout << vehicle.GetNumberOfWheels() << std::endl; 

std::cout << car.GetNumberOfWheels() << std::endl; 

std::cout << motorcycle.GetNumberOflheels() << std::endl; 
} 


Motorcycle inherits from Vehicle, just as Car does, but it sets the number of wheels to 2 and this is 
printed out when we call the PrintNumber0fWheels function. 


You now understand the basics of how to create classes that inherit behaviors from base classes. 
Now I'll move on to show you how this works in practice. 


Constructors and Destructors in Derived Classes 


In the previous section you saw that we can set values in member variables belonging to our parent 
class if the variables were declared as protected or public. Listing 10-7 shows the constructors 
from the Vehicle, Car, and Motorbike classes. 


Listing 10-7. Your Vehicle, Car, and Motorbike Constructors 


Vehicle: :Vehicle() 
: m_numberOfWheels (0) 
{ 


} 


Car: :Car() 


m_numberOfWheels = 4; 
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Motorcycle: :Motorcycle() 
{ 


} 


m_numberOfWheels = 2; 


The Vehicle class constructor sets m_numberOfVehicles to 0 in an initializer list. Car and Motorbike 
assign the values directly as an initializer list cannot be used on nonmember variables from our base 
class. What you might be surprised to hear is that the Vehicle constructor is called automatically 
when we create a Car or Motorbike object. You can see this in practice by adding some logging code 
to the constructors, which we do in Listing 10-8. 


Listing 10-8. Adding Logging to Your Constructors 


Vehicle: :Vehicle() 
: m_numberOfWheels (0) 


{ 
std::cout << "Vehicle Constructed" << std::endl; 
} 
Car: :Car() 
{ 
m_numberOfWheels = 4; 
std::cout << "Car Constructed" << std::endl; 
} 
Motorcycle: :Motorcycle() 
{ 
m_numberOfWheels = 2; 
std::cout << "Motorcycle Constructed" << std::endl; 
} 


If you execute the PrintNumberOfVehicles function from Listing 10-6 once more you will see that we 
have some new text in the output. It should read: 


Vehicle Constructed 
Vehicle Constructed 
Car Constructed 
Vehicle Constructed 
Motorcycle Constructed 
0 


4 
2 


Vehicle Constructed is printed three different times. That is because the Vehicle constructor 

is being called each time any class that derives from Vehicle is instantiated. The order of the 
constructors is important: The constructors of parent classes are called before the constructors of 
derived classes. You can see this in action where the Vehicle Constructed output text is printed 
before both Car Constructed and Motorcycle Constructed. 
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C++ supplies classes with a destructor as well as a constructor. Listing 10-9 shows what destructors 
for the Vehicle, Car, and Motorcycle classes could look like. 


Listing 10-9. Vehicle, Car, and Motorcycle Destructors 


Vehicle: :~Vehicle() 


{ 
std::cout << "Vehicle Destructed" << std::endl; 
} 
Car::~Car() 
std::cout << "Car Destructed" << std::endl; 
} 
Motorcycle: :~Motorcycle() 
{ 
std::cout << "Motorcycle Destructed” << std::endl; 
} 


Destructors are defined in a similar manner to constructors. They do not have a return value and 
they use the name of the class. A destructor is shown to be different from a constructor by having 
the ~ symbol added to its name. 


If you execute the PrintNumberOfWheels function again with these destructors in place you will see 
the following output: 


Vehicle Constructed 
Vehicle Constructed 
Car Constructed 
Vehicle Constructed 
Motorcycle Constructed 
0 

4 

2 

Motorcycle Destructed 
Vehicle Destructed 
Car Destructed 
Vehicle Destructed 
Vehicle Destructed 


You can deduce a few things from this output. First, you can see that any local variables that are created 
from classes are automatically destroyed when the function returns. This is known as going out of 
scope. Second, you can see that destructors are called automatically when locally instantiated objects 
go out of scope. Third, you can see that the destructors for the base classes are also called; that is, 
“Vehicle is called for both Car and Motorcycle. Finally, you should note that the objects are destroyed 

in the reverse order in which they were created. The motorcycle object is destroyed before car, which is 
destroyed before vehicle. This is a useful feature that we use to our advantage later in this book. 


Method overriding is the final feature of class inheritance you'll learn in this chapter. 
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Method Overriding 


Earlier in this chapter, you saw how we can change the number of wheels in derived classes by 
changing the value of a variable in the derived class’s constructor. Although that is a more correct 
method for achieving this, | will show you how we could have achieved a similar outcome using 
method overriding in this chapter. To use method overriding we will create a GetNumberOfWheels 
method in each of our three classes. Listing 10-10 shows these methods. 


Listing 10-10. Overriding GetNumberOfWheels 


unsigned int Vehicle: :GetNumberOfWheels() const 


return 0; 
} 
unsigned int Car::GetNumberOfWheels() const 
{ 
return 4; 
} 
unsigned int Motorcycle: :GetNumberOfWheels() const 
{ 
return 2; 
} 


Now each of your classes has a method with an identical name. In the PrintNumberOfWheels method 
so far, each call to GetNumberOfWheels called Vehicle: :GetNumberOfWheels, which returned the value 
stored in m_numberOfWheels. With method overriding the compiler will call the GetNumberOfWheels 
method for the appropriate class; therefore, we will see calls to Car: :GetNumberOfWheels and 
Motorcycle: :GetNumberOfWheels in the proper place in our PrintNumberOfWheels function. 


Updating Text Adventure 


The Text Adventure game you are building has fairly limited functionality at this point. In this chapter 
we are going to add some rooms to the game and update Player to be inherited from a class named 
Entity. 


Creating an Entity Class 


Entity will be our game’s base class for all objects that exist in the game world. Listing 10-11 shows 
the code for Entity. 


Listing 10-11. The Entity Class 


class Entity 
{ 
public: 
void Update() {} 
}; 
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Our Entity class at the moment is very straightforward; all we want it to do is provide our inherited 
classes with an Update method. The Update method can be important when developing game 
software, as your program will likely be updating your objects once per frame. 


Adding Inheritance to the Player Class 

Your Player class can now be changed to inherit from Entity. The new Player class can be seen in 
Listing 10-12. 

Listing 10-12. Inheriting Player from Entity 


class Player 
: public Entity 


{ 
private: 
std::string m_name; 
public: 
Player() 
} 
void SetName(const std::string& name) 
{ 
m name = name; 
} 
const std::string& GetName() const 
{ 
return m_name; 
} 
3 


You will see what the Player class’s Update method will look like once we have added some rooms 
for the player to move through. 


Adding Rooms 


To be able to have the player move through rooms in the game you will need to create a Room class, 
and the code for this is shown in Listing 10-13. 


Listing 10-13. The Room Class 


class Room 
: public Entity 
{ 
public: 
enum class JoiningDirections 
{ 
North = 0, 


East, 
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}3 


private: 
Room* m_pJoiningRooms[JoiningDirections: :Max]; 


public: 
Room(); 


void AddRoom(JoiningDirections direction, Room* pRoom) ; 
Room* GetRoom(JoiningDirections direction) const; 


}; 
Room: :Room() 
{ 
for (unsigned int i = 0; 
i < static_cast<unsigned int>(JoiningDirections: :Max) ; 
++i) 
{ 
m_pJoiningRooms[i] = nullptr; 
} 
} 
void Room: :AddRoom(Room::JoiningDirections direction, Room* pRoom) 
{ 
m_pJoiningRooms[static_cast<unsigned int>(direction)] = pRoom; 
} 
Room* Room: :GetRoom(Room::JoiningDirections direction) const 
{ 
return m_pJoiningRooms[static_cast<unsigned int>(direction) ]; 
} 


For now, a Room is a simple object. We have inherited from Entity and have created an array to store 
pointers to connecting rooms. There is an enum class that is used to enumerate the four different 
directions in which rooms can be connected to the current room. The value of North is set to 0 in our 
enum class as we will be using these values to index into our array of Room pointers. You can see this 
in action in the method Room: :AddRoom where we must static_cast the value of direction to be able 
to index into our array and assign the passed Room* to the correct array member. The final method 

in Room is GetRoom, which will allow us to get the pointer to a room adjoining any given room for the 
supplied direction. 


Now that you have a room class you will be able to add some rooms to our Game class. You can see 
how this is done in Listing 10-14. 
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Listing 10-14. Adding a Room Array to Game 


class Game 


{ 

private: 
static const unsigned int m_numberOfRooms = 4; 
Room m_rooms[m numberOfRooms ] ; 


Player m_player; 


void InitializeRooms(); 

void WelcomePlayer(); 

void GivePlayerOptions() const; 

void GetPlayerInput(std::string& playerInput) const; 

PlayerOptions EvaluateInput(std::string& playerInput) const; 
public: 


void RunGame() ; 


}3 


The Game class now has an array that stores all of the Room objects our game requires. We can 
increase the number of rooms by increasing the value stored in the static const variable 
m_numberOfRooms. The new method, InitializeRooms, is shown in Listing 10-15 and is responsible 
for creating the connections between the different Room objects. 


Listing 10-15. Game: : InitializeRooms 


void Game: :InitializeRooms() 


{ 


// Room O heads North to Room 1 
m_rooms[0].AddRoom(Room: : JoiningDirections::North, &(m_rooms[1])); 


// Room 1 heads East to Room 2, South to Room O and West to Room 3 
m_rooms[1].AddRoom(Room: : JoiningDirections::East, &(m_rooms[2])); 
m_rooms[1].AddRoom(Room: : JoiningDirections::South, &(m_rooms[0])); 
m_rooms[1].AddRoom(Room: : JoiningDirections::West, &(m_rooms[3])); 


// Room 2 heads West to Room 1 
m_rooms[2].AddRoom(Room: :JoiningDirections::West, &(m_rooms[1])); 


// Room 3 heads East to Room 1 
m_rooms[3].AddRoom(Room: : JoiningDirections::East, &(m_rooms[1])); 


} 


It is important to make sure that any Room that connects to another also has that Room connect back 
or the player might be able to get into a Room and not able to get back out. Listing 10-16 shows an 
option for where you can call InitializeRooms. 
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Listing 10-16. Calling InitializeRooms from Game: :RunGame 


void Game: :RunGame() 


{ 


InitializeRooms(); 
WelcomePlayer(); 


bool shouldEnd = false; 
while (shouldEnd == false) 


{ 
GivePlayerOptions(); 


string playerInput; 
GetPlayerInput (playerInput) ; 


shouldEnd = EvaluateInput(playerInput) == PlayerOptions: :Quit; 
} 


Now that you have some Room objects in the game, you will need to keep track of which Room the 
player is currently in. You can do this by adding a pointer to a Room to the Player object. Listing 10-17 
shows how this can be achieved. 


Listing 10-17. Adding a Room Pointer to Player 


class Room; 


class Player 
: public Entity 


{ 
private: 
const Room* m_pCurrentRoom; 
std::string m_name; 
public: 
Player() 
{ 
} 
void SetName(const std::string& name) 
{ 
m_name = name; 
} 


const std::string& GetName() const 


{ 
} 


return m_name; 
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void SetCurrentRoom(const Room* pCurrentRoom) 


{ 
m_pCurrentRoom = pCurrentRoom; 
} 
const Room* GetCurrentRoom() const 
{ 
return m_pCurrentRoom; 
} 


}3 


The Player class contains a pointer to a Room object and accessor methods to set and retrieve the 
current Room. 


Note We did not have to include Room.h in the Player.h file to add a pointer to the Player class. What 
you see in Listing 10-17 is known as a forward declaration. A forward declaration can be used when only 

a pointer or reference to an object is used in a header file and not the object itself. You are only required to 
include the full class definition if you were going to call a method on an object or instantiate a class in any 
given file. 


I’ve added another line to InitializeRooms to set the Player's current Room pointer in Listing 10-18. 


Listing 10-18. Setting m_player's Current Room 


void Game: : InitializeRooms() 


{ 
// Room 0 heads North to Room 1 
m_rooms[0].AddRoom(Room: : JoiningDirections::North, &(m_rooms[1])); 


// Room 1 heads East to Room 2, South to Room O and West to Room 3 
m_rooms[1].AddRoom(Room: : JoiningDirections::East, &(m_rooms[2])); 
m_rooms[1].AddRoom(Room: : JoiningDirections::South, &(m_rooms[0])); 
m_rooms[1].AddRoom(Room: : JoiningDirections::West, &(m_rooms[3])); 


// Room 2 heads West to Room 1 
m_rooms[2].AddRoom(Room: : JoiningDirections::West, &(m_rooms[1])); 


// Room 3 heads East to Room 1 
m_rooms[3].AddRoom(Room: : JoiningDirections::East, &(m_rooms[1])); 


m_player.SetCurrentRoom(&(m_rooms[0])) 5; 


} 


Now that you have rooms and a way to store which room the player is in, you should add some 
options to allow the player to move through those rooms. 
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Moving Through Rooms 


Listing 10-19 updates the Game: :RunGame method to store the user’s selected option and call a new 
UpdateOnOption method. 


Listing 10-19. Updating Game : :RunGame 


void Game: :RunGame() 


{ 
InitializeRooms(); 
WelcomePlayer(); 
bool shouldEnd = false; 
while (shouldEnd == false) 
{ 
GivePlayerOptions(); 
string playerInput; 
GetPlayerInput (playerInput) ; 
PlayerOptions selectedOption = EvaluateInput(playerInput) ; 
shouldEnd = selectedOption == PlayerOptions: :Quit; 
if (shouldEnd == false) 
{ 
UpdateOnOption(selectedOption) ; 
} 
} 
} 


RunGame now stores the result from EvaluateInput and calls UpdateOnOption if the player has 
not chosen to quit. Before | show you the code for UpdateOnOption we will look at the updated 
GivePlayerOptions and EvaluateInput methods in Listing 10-20. 


Listing 10-20. Updating GivePlayerOptions and EvaluateInput 


void Game: :GivePlayerOptions() const 
{ 

cout << "What would you like to do? (Enter a corresponding number)" 

<< endl << endl; 

cout << "1: Go North" << endl << endl; 
cout << "2: Go East" << endl << endl; 
cout << "3: Go South" << endl << endl; 
cout << "4: Go West" << endl << endl; 
cout << "5: Quit" << endl << endl; 
} 


PlayerOptions Game: :EvaluateInput(string& playerInput) const 
{ 


PlayerOptions chosenOption = PlayerOptions: :None; 
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if (playerInput.compare("1") == 0) 


cout << "You 


have chosen to Go North!" << endl << endl; 


chosenOption = PlayerOptions: :GoNorth; 

} 

else if (playerInput.compare("2") == 0) 

{ 
cout << "You have chosen to Go East!" << endl << endl; 
chosenOption = PlayerOptions: :GoEast; 

} 

else if (playerInput.compare("3") == 0) 

{ 
cout << "You have chosen to Go South!" << endl << endl; 
chosenOption = PlayerOptions: :GoSouth; 

} 

else if (playerInput.compare("4") == 0) 

{ 
cout << "You have chosen to Go West!" << endl << endl; 
chosenOption = PlayerOptions: :GoWest; 

} 

else if (playerInput.compare("5") == 0) 

{ 
cout << "You have chosen to Quit!" << endl << endl; 
chosenOption = PlayerOptions: :Quit; 

} 

else 

{ 
cout << "I do not recognize that option, try again!" << endl << endl; 

} 


return chosenOption; 


} 


Your player will now see options 1 through 5 to choose which room to move to or whether he or she 
would like to quit. The last task required is to move the m_player object to the new selected Room. 
Listing 10-21 shows how you can achieve this in the new UpdateOnOption method. 


Listing 10-21. Moving the Player in UpdateOnOption 


void Game: :UpdateOnOption(PlayerOptions selectedOption) 


{ 
if (selectedOption == PlayerOptions::GoNorth || 
selectedOption == PlayerOptions::GoEast | | 
selectedOption == PlayerOptions::GoSouth | | 
selectedOption == PlayerOptions: :GoWest) 


Room: :JoiningDirections directionToMove 
= Room: : JoiningDirections: :North; 
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switch (selectedOption) 
{ 


case PlayerOptions: :GoEast: 


directionToMove = Room: :JoiningDirections: :East; 


} 


break; 


case PlayerOptions: :GoSouth: 


{ 
} 


break; 


directionToMove = Room: :JoiningDirections: :South; 


case PlayerOptions: :GoWest: 


{ 
} 


break; 


directionToMove = Room: :JoiningDirections: :West; 


const Room* pPlayerCurrentRoom = m player.GetCurrentRoom() ; 
const Room* pNewRoom = pPlayerCurrentRoom->GetRoom(directionToMove) ; 
if (pNewRoom != nullptr) 

m_player.SetCurrentRoom(pNewRoom) ; 


else 


const char* strDirection = "North"; 
switch (selectedOption) 


{ 
case PlayerOptions: :GoEast: 
{ 
strDirection = "East"; 
} 
break; 


case PlayerOptions: :GoSouth: 
strDirection = "South"; 

} 

break; 

case PlayerOptions: :GoWest: 


strDirection = "West"; 


break; 
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cout << "There is no room to the " 
<< strDirection << endl << endl; 


} 


The UpdateOnOption method can be broken down into three main sections. First it works out which 
direction the player would like to move in from the supplied option. It does this using the first switch 
statement in the method. It then updates the current Room pointer stored by m_player so long as the 
Room we are trying to move to is valid and not a nullptr. If the chosen Room is a nullptr, the method 
then outputs to the player that there is no room in the direction in which he or she tried to move. 


You now have the ability to move through the game world. Congratulations! We could stop learning 
about C++ at this point and have the ability to write a full-text adventure game with everything you 
have learned so far; however, your code would be very long and you would find yourself repeating 
certain code over and over again. The rest of this book will try to expand your knowledge of C++ 
and show you how some more advanced features of the language can be used to cut down on the 
amount of code you have to write. 


Summary 


This chapter has introduced you to the concept of class inheritance. The inheritance you’ve seen in 
this chapter is useful for sharing behavior and code between objects that can be logically grouped 
together. Vehicles are a classic example used to introduce new programmers to inheritance, as it is 
a simple set of objects to group logically and they have simple features that can be used to show 
differences between different members of the set. 


You’ve seen in this chapter that the access specifier (public, protected, and private) used when 
declaring class member variables has an important part to play in sharing data between base 
classes and their derived children. You’ve also learned that constructors and destructors play an 
important role in the creation and destruction of objects and in which order they are called. Finally 
you learned that it’s possible to alter the behavior of a derived class by overriding methods that exist 
in a parent class by defining a method with the same signature in the derived class. 


The following chapter is going to introduce you to the concept of polymorphism. Polymorphism 
allows us to create class interfaces and abstract out class implementations. This is a very powerful 
technique that you will find used in game play, engine, and cross-platform game programming. 

The code you have seen in this chapter for the Text Adventure game will be rewritten once you 
understand the concepts behind polymorphism and you will see how much simpler and clean-looking 
your code can be. 


__ 


Chapter 


Designing Game Code 
with Polymorphism 


You saw how inheritance can be used to design reusable code in the last chapter. In this chapter 
you will learn how the power of inheritance can be unlocked in much more useful ways through 

the power of polymorphism. C++ supports the ability to access classes of different types through 
pointers to a base class, known as polymorphism. The program can determine the type of the object 
at runtime and call the correct method. The mechanism supplied by C++ to tell the compiler that a 
method can be different in the base class to any derived classes is the virtual method. 


Virtual Methods 


You have seen that methods in class hierarchies can be overridden, which allows the compiler to call 
a given method for a class type rather than call the version from the base class when accessing an 
object of a given type. When you use polymorphism, the compiler cannot tell what the actual type of 
the object is and therefore we must write our methods in a different manner. Listing 11-1 shows how 
the Vehicle class can be modified to turn the GetNumber0fWheels method into a virtual method. 


Listing 11-1. Creating a Virtual Method 


class Vehicle 


{ 
public: 
Vehicle(); 
~Vehicle(); 
virtual unsigned int GetNumberOfWheels() const 
{ 
return 0; 
} 
3 
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You create virtual methods by adding the virtual keyword to the beginning of the method signature. 
The method GetNumber0fWheels is now a virtual method. To get the benefit of this, Listing 11-2 
updates the Car and Motorcycle classes to make their GetNumberOfWheels methods virtual. 


Listing 11-2. Making GetNumberOfWheels Virtual inCar andMotorcycle 


class Car : public Vehicle 


{ 
public: 
Car(); 
~Car(); 
virtual unsigned int GetNumberOfWheels() const 
{ 
return 4; 
} 
3 
class Motorcycle : public Vehicle 
{ 
public: 
Motorcycle(); 
~Motorcycle(); 
virtual unsigned int GetNumberOfWheels() const 
{ 
return 2; 
} 
5 


The code in Listing 11-2 completes our updates to the GetNumberOfWheels methods in the Vehicle, 
Car, and Motorcycle classes. Listing 11-3 modifies the PrintNumberOfWheels method to make use of 
polymorphism. 


Listing 11-3. Using Polymorphism in PrintNumberOfwWheels 


void PrintNumberOfwWheels() 

{ 
Vehicle vehicle; 
Car car; 
Motorcycle motorcycle; 


Vehicle* pVehicle = &vehicle; 
std::cout << pVehicle->GetNumberOfWheels() << std::endl; 


pVehicle = &car; 
std::cout << pVehicle->GetNumberOfWheels() << std::endl; 


pVehicle = &motorcycle; 
std::cout << pVehicle->GetNumberOfWheels() << std::endl; 
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The code in PrintNumber0fWheels now accesses the GetNumberOfWheels methods of Vehicle, 
Car, and Motorcycle through a pointer to the Vehicle class. The output from this program is still 
correct. The first std: : cout will print 0, the second will print 4, and the third will print 2. This is 
a perfect example of polymorphism in action: This code calls the Car: :GetNumberOfWheels and 
Motorcycle: :GetNumberOfWheels methods through a Vehicle pointer. 


Once you begin to write more complex polymorphic programs you will find you’ll need to cast to the 
proper derived types in certain circumstances. C++ provides the dynamic_cast for these situations. 


Downcasting and Upcasting with dynamic_cast 


Moving between different types at runtime is usually an unsafe operation. In complex code it can 
sometimes be difficult to be sure where pointers have come from, what they point to, and which 
other classes exist in the class hierarchy for a given type. You should use dynamic_cast in these 
situations to be sure that your code does not crash when converting between types. Listing 11-4 
adds some code to PrintNumberOfWheels to show you how dynamic_cast can be used. 


Listing 11-4. Using dynamic_cast to Downcast 


void PrintNumberOfwWheels() 
{ 


Vehicle vehicle; 
Car car; 
Motorcycle motorcycle; 


Vehicle* pVehicle = &vehicle; 
std::cout << pVehicle->GetNumberOfWheels() << std::endl; 


pVehicle = &car; 

Car* pCar = dynamic_cast<Car*>(pVehicle) ; 
if (pCar != nullptr) 

{ 


std::cout << pCar->GetNumberOfWheels() << std::endl; 
} 


pVehicle = &motorcycle; 

pCar = dynamic_cast<Car*>(pVehicle) ; 
if (pCar != nullptr) 

{ 


std::cout << pCar->GetNumberOfWheels() << std::endl; 


} 


Listing 11-4 has two dynamic_cast calls to convert the current value stored in pVehicle to a pointer 
to a Car object. The result of a dynamic_cast can either be a valid pointer to the requested class or 
nullptr. This means that we must ensure that the result of a dynamic_cast is valid before trying to 
dereference the resulting pointer or our application can crash. The first cast in Listing 11-4 results in 
a valid pointer and therefore the number of wheels for a car will be printed out. The second cast will 
fail and return nullptr. Both of these casts were attempts at a downcast. You can visualize a class 
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hierarchy as having the base class at the top and all child classes below that. Casting from a higher 
class to a lower class is a downcast and the opposite is an upcast. The code in Listing 11-5 is safer 
than the code in Listing 11-4, as we use dynamic_cast to upcast to the Vehicle pointer. 


Listing 11-5. Upcasting 


void PrintNumberOfwWheels() 


Vehicle vehicle; 
Car car; 
Motorcycle motorcycle; 


Vehicle* pVehicle = dynamic_cast<Vehicle*>(&vehicle) ; 
std::cout << pVehicle->GetNumberOfWheels() << std::endl; 


pVehicle = dynamic_cast<Vehicle*>(&car) ; 
Car* pCar = dynamic_cast<Car*>(pVehicle) ; 
if (pCar != nullptr) 


std::cout << pCar->GetNumberOfWheels() << std::endl; 
} 


pVehicle = dynamic_cast<Vehicle*> (motorcycle) ; 
pCar = dynamic_cast<Car*>(pVehicle) ; 

if (pCar != nullptr) 

{ 


std::cout << pCar->GetNumberOfWheels() << std::endl; 


} 


The upcasts to Vehicle in Listing 11-5 are all much safer than the previous implicit casts. This would 
not matter too much in this example code, as we know all of the objects derive from Vehicle, but in 
production code you might not be able to guarantee that a given pointer derives from a specific 
base class. 


Creating Interfaces with Pure Virtual Methods 


The Vehicle class has a value to return for GetNumberOfWheels. In a proper program it would be 
unlikely that we would want to be able to create basic Vehicle objects as we are more likely to want 
to create instances of Car or Motorcycle. It also makes little sense for a Vehicle to have any number 
of wheels, even none. We can turn Vehicle into an interface by making its GetNumberOfwWheels class a 
pure virtual method. Listing 11-6 shows how to do this. 


Listing 11-6. Making Pure Virtual Methods 


class Vehicle 
{ 
public: 
virtual unsigned int GetNumberOflheels() const = 0; 


B 
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Pure virtual methods are created by adding = 0 to the end of the method declaration. The method 
then does not contain a body, as we do not wish to have any code associated with the method in 
this class. Adding a pure virtual method to a class turns the class into an abstract class. Abstract 
classes cannot be instantiated, which means we can no longer create Vehicle objects. You will 
need to remove the instance of Vehicle in PrintNumberOfWheels. Listing 11-7 shows a version of the 
function with this removed. 


Listing 11-7. Removing Vehicle from PrintNumberOfWheels 


void PrintNumberOfwWheels() 
{ 


Car car; 
Motorcycle motorcycle; 


Vehicle* pVehicle = dynamic_cast<Vehicle*>(&car) ; 
Car* pCar = dynamic_cast<Car*>(pVehicle) ; 

if (pCar != nullptr) 

{ 


std::cout << pCar->GetNumberOfWheels() << std::endl; 
} 


pVehicle = dynamic_cast<Vehicle*>(&motorcycle) ; 
pCar = dynamic_cast<Car*>(pVehicle) ; 
if (pCar != nullptr) 


std::cout << pCar->GetNumberOfWheels() << std::endl; 
} 


Another effect of the pure virtual method is that it turns Vehicle into an interface class. Interface 
classes are usually simply referred to as interfaces. Any pure virtual methods in a parent class must 
be overridden in a class that you wish to be able to instantiate. You might recall that the notion of 
contracts was touched on in Chapter 8 when we discussed OOP. Using interfaces is one method 
that you can use to define these contracts. You can try commenting out the GetNumberOfWheels 
methods from the Car and Motorcycle classes to see the compiler errors that are generated. 


Using Polymorphism in Text Adventure 


The options that have been supplied to the player in Text Adventure have so far been coded procedurally. 
You can make it much easier to add new options by using a more object-oriented approach to the 
system. Listing 11-8 shows the Option interface that you can use to create future options. 


Listing 11-8. The Option Class 


class Option 

{ 

protected: 
PlayerOptions m_chosenOption; 
std::string m_outputText; 
std::string m_optionText; 
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public: 
Option(PlayerOptions chosenOption, const std::string& outputText) 
: m_chosenOption(chosenOption) 
» m outputText (outputText) 
{ 
} 
void Option: :SetOptionText(const std::string& optionText) 
{ 
m_optionText = optionText; 
} 
const std::string& GetOutputText() const 
{ 
return m_outputText; 
} 
PlayerOptions GetChosenOption() const 
{ 
return m_chosenOption; 
} 
virtual bool Evaluate(const std::string optionText, Player& player) = 0; 
}; 


The Option class stores the PlayerOption value that it represents as well as the text that is output to 
the player and a string to compare to the text the player enters. You can then derive specific classes 
from Option, the MoveOption and QuitOption classes. Listing 11-9 shows the MoveOption class and 
Listing 11-10 shows the QuitOption class. 


Listing 11-9. The MoveOption Class 


class MoveOption 


{ 


private: 
Room: :JoiningDirections m_directionToMove; 


public Option 


public: 

MoveOption(Room: :JoiningDirections joiningDirection, 
PlayerOptions chosenOption, 
const std::string& outputText) 
: Option(chosenOption, outputText) 
» m_directionToMove(joiningDirection) 

{ 

} 


virtual bool Evaluate(const std::string& optionText, Player& player); 
}; 
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bool MoveOption: :Evaluate(const std::string optionText, Player& player) 


{ 


} 


bool handled = false; 


if (m_optionText.compare(optionText) == 0) 


{ 


} 


const Room* pPlayerCurrentRoom = player.GetCurrentRoom(); 
const Room* pNewRoom = pPlayerCurrentRoom->GetRoom(m directionToMove) ; 
if (pNewRoom != nullptr) 


{ 
player .SetCurrentRoom(pNewRoom) ; 
std::cout << "You have chosen to " 
<< m_outputText << std::endl << std::endl; 
} 
else 
{ 
const char* strDirection = "North"; 
switch (m_chosenOption) 
{ 
case PlayerOptions: :GoEast: 
{ 
strDirection = "East"; 
} 
break; 
case PlayerOptions: :GoSouth: 
{ 
strDirection = "South"; 
} 
break; 
case PlayerOptions: :GoWest: 
strDirection = "West"; 
} 
break; 
} 
std::cout << "There is no room to the " 
<< strDirection << std::endl << std::endl; 
} 


handled = true; 


return handled; 


The MoveOption class now contains all of the code necessary to work out if the player has chosen 
to move to another room and the code necessary to change the Player class Room pointer to the 
appropriate Room object. 
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Listing 11-10. The QuitOption Class 


class QuitOption 
: public Option 


{ 
private: 
bool m_shouldQuit; 
public: 
QuitOption(const std::string& outputText) 
: Option(PlayerOptions::Quit, outputText) 
» m shouldQuit (false) 
{ 
} 
bool ShouldQuit() const { return m shouldQuit; } 
virtual bool Evaluate(const std::string& optionText, Player& player); 
}; 
bool QuitOption: :Evaluate(const std::string optionText, Player& player) 
{ 
m_ shouldQuit = m_optionText.compare(optionText) == 0; 
if (m_shouldQuit == true) 
{ 
std::cout << "You have chosen to quit!" << std::endl << std::endl; 
} 
return m_shouldQuit; 
} 


The QuitOption determines whether the player has chosen to quit the game. Listing 11-11 shows 
how you can add these options to the Game class. 


Listing 11-11. Adding the New Options to Game 


class Game 

{ 

private: 
static const unsigned int m_numberOfRooms = 4; 
Room m_rooms[m_numberOfRooms ] ; 


Player m_player; 


MoveOption m_moveNorthOption; 
MoveOption m_moveEastOption; 
MoveOption m_moveSouthOption; 
MoveOption m_movellestOption; 
QuitOption m_quitOption; 


static const unsigned int m_numberOfOptions = 5; 
Option* m_options[m_numberOfOptions] ; 
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void InitializeRooms(); 

void WelcomePlayer(); 

void GivePlayerOptions() const; 

void GetPlayerInput(std::string& playerInput) const; 

PlayerOptions EvaluateInput(std::string& playerInput) ; 
public: 

Game(); 


void RunGame() ; 


F 


There are four MoveOption instances, one QuitOption instance, and an array of Option pointers. 
The constructor of the class is also new. Listing 11-12 shows the constructor for Game. 


Listing 11-12. The Game Class Constructor 


Game: : Game () 

: m_moveNorthOption(Room: : JoiningDirections: :North, 
PlayerOptions: :GoNorth, 
"Go North") 

» m_moveEastOption(Room: : JoiningDirections: :East, 
PlayerOptions: :GoEast, 
"Go East") 

» m_moveSouthOption(Room: : JoiningDirections: :South, 
PlayerOptions: :GoSouth, 
"Go South") 

» m_moveWestOption(Room: : JoiningDirections: :West, 
PlayerOptions: :GoWest, 
"Go West") 

» m_quitOption("Quit") 


{ 
m_options[0] = dynamic_cast<Option*>(&m_moveNorthOption) ; 
m_options[1] = dynamic_cast<Option*>(&m moveEastOption) ; 
m_options[2] = dynamic_cast<Option*>(&m_moveSouthOption) ; 
m_options[3] = dynamic_cast<Option*>(&m moveWestOption) ; 
m_options[4] = dynamic_cast<Option*>(&m_ quitOption) ; 

} 


The Game class constructor initializes the Option class objects and the array of pointers. Next you 
need to update the Game: :GivePlayerOptions method. You can see how this is done in Listing 11-13. 


Listing 11-13. Updating Game: :GivePlayerOptions 


void Game: :GivePlayerOptions() const 
{ 
cout << "What would you like to do? (Enter a corresponding number)" 
<< endl << endl; 
for (unsigned int i = 0; i < m_numberOfOptions; ++i) 
{ 
Option* option = m options[i]; 
const unsigned int chosenOption = i + 1; 
cout << chosenOption << ": " << option->GetOutputText() << endl << endl; 
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std: :ostringstream chosenOptionString; 
chosenOptionString << chosenOption; 
option->SetOptionText (chosenOptionString.str()); 


} 


The GivePlayerOptions method loops over the array of Option pointers, displays the options that 
the user can select for each option, and sets the option text on the Option object. This method now 
does not have to be changed as we add new options to the option array. The user input option 

will automatically update as we change the array and the output text that we enter into the Option 
constructors. The EvaluateInput method also gets an update in Listing 11-14. 

Listing 11-14. The EvaluateInput Method 


PlayerOptions Game: :EvaluateInput(string& playerInput) 
PlayerOptions chosenOption = PlayerOptions: :None; 
for (unsigned int i = 0; i < m_numberOfOptions; ++i) 
Option* option = m options[i]; 
bool handled = option->Evaluate(playerInput, m player); 


if (handled == true) 
{ 


chosenOption = option->GetChosenOption(); 
break; 


} 
if (chosenOption == PlayerOptions: :None) 


cout << "I do not recognize that option, try again!" << endl << endl; 


} 


return chosenOption; 


} 


The EvaluateInput method has been simplified. It now also loops over the Option array and calls 
Evaluate on each Option object. The last method to get an update is RunGame in Listing 11-15. 


Listing 11-15. The RunGame Method 


void Game: :RunGame() 
{ 
InitializeRooms(); 


WelcomePlayer(); 


bool shouldEnd = false; 
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while (shouldEnd == false) 


{ 
GivePlayerOptions(); 
string playerInput; 
GetPlayerInput (playerInput) ; 
PlayerOptions selectedOption = EvaluateInput(playerInput) ; 
shouldEnd = selectedOption == PlayerOptions: :Quit; 
} 


} 


The Update0nOption method from Chapter 10 has been removed, as the code from that method has 
been moved into the MoveOption class. This allows you to remove the call to that method from the 
RunGame class. 


Summary 


This chapter has introduced polymorphism. This allows you to write code that is more flexible and 
reusable. You have seen that base class pointers combined with virtual methods allow a programmer 
to create interfaces and code that allows programs to evaluate their behavior at runtime for the 
correct course of action. You have also seen how the dynamic_cast allows you to ensure that 

you can safely move from one type of object pointer to another. Pure virtual functions were then 
introduced, along with an example of how you can create abstract classes that enforce specific 
methods to be overridden in classes that derive from that class. 


The chapter ended with a practical example of how you can use polymorphism to improve your 
code in a number of ways. The Option class creates a simple interface for in-game options. The 
MoveOption and QuitOption classes show how you can use virtual methods to create types to 
represent specific actions. Finally, you saw that polymorphism can be used to write methods that are 
reusable and easily maintainable. New options can be added to Text Adventure without the need to 
alter the Game GivePlayerOptions and EvaluateInput methods. 


Chapter 1 2 


Copying and Assigning Data 
to Objects 


You have seen how we can pass data into functions by value, by reference, or by pointer. If you 
choose to pass a class object into a function by value, C++ will make a copy of the class. This copy 
operation happens automatically or implicitly. This chapter is going to show you some of these 
implicit operations that can occur when using classes in your programs and the ways in which you 
can alter and manage these implicit operations. 


Copy Constructors 


Classes in C++ can use constructors and destructors to initialize and clean up the objects that 
you use in your programs. C++ also allows you to specify a copy constructor that is called when 
an object is being copied into a new instance of an object. Listing 12-1 shows a simple copy 
constructor. 


Listing 12-1. A Copy Constructor 


class Player 
: public Entity 
{ 
private: 
const Room* m_pCurrentRoom; 


std::string m_name; 


public: 
Player() 
{ 


} 
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Player(const Player& originalPlayer) 


m_pCurrentRoom = originalPlayer.m_pCurrentRoom; 
m_name = originalPlayer.m_name; 


} 
void SetName(const std::string& name) 
{ 
m_ name = name; 
} 
const std::string& GetName() const 
{ 
return m_name; 
} 
void SetCurrentRoom(const Room* pCurrentRoom) 
{ 
m_pCurrentRoom = pCurrentRoom; 
} 
const Room* GetCurrentRoom() const 
{ 
return m_pCurrentRoom; 
} 


Js 


The copy constructor in Listing 12-1 is a constructor method that takes a constant reference to an 
object of the same type of class; in this case the Player copy constructor takes a constant reference 
to another Player object. Copy constructors are an added cost when passing objects into functions. 
Usually you would be better served by passing a constant reference into the function instead. Copy 
constructors are mostly useful when you wish to return a new instance of an object from a function. 
When you do this, the object you are returning will go out of scope and be destroyed after the 
function has returned. Returning objects by value ensures that you are not exposed to bugs caused 
by trying to return references to local variables that no longer exist. Listing 12-2 shows two different 
functions that take a player by value and by constant reference. 


Listing 12-2. Passing by Value and const Reference 


void CopyPlayer(Player player) 
{ 


} 


void PassPlayerByConstReference(const Player& player) 


{ 
} 
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Any code that you could place inside these methods would be identical and all of the data contained 
by both would also be the same. The major difference between the two methods is the length of time 
it takes to execute the two. Passing player by value would invoke the copy constructor, whereas 
passing a constant reference does not. Using a constant reference therefore avoids the time taken to 
call the copy constructor method and the length of time it takes to execute a full copy of the class. 


Passing by a constant reference also helps protect programmers against another more subtle 
problem. The first method has passed the class by value and therefore the player parameter is a 
copy of the original object. If you then called any methods that set values on the parameter, that data 
would be lost when the function returns. You can get around this by declaring the copied object as 
const; however, at that point there’s no reason why you wouldn’t also use a reference. Using const 
variables with copied objects will cause the compiler to throw errors if you try to call public methods 
on the object, which helps to avoid a source of errors and bugs in your games. 


Assignment Operators 


Although copy constructors will be invoked when passing objects by value into functions or 
methods, assignment operators are invoked when using the = operator on objects. Listing 12-3 
shows how you can overload an assignment operator on the Player class. 


Listing 12-3. The Player Assignment Operator 
class Player 


: public Entity 
{ 


private: 
const Room* m_pCurrentRoom; 
std::string m_name; 


public: 
Player() 


Player(const Player& originalPlayer) 


m_pCurrentRoom = originalPlayer.m_pCurrentRoom; 
m_name = originalPlayer.m_name; 


} 
Player& operator=(const Player& originalPlayer) 
m_pCurrentRoom = originalPlayer.m_pCurrentRoom; 


m_name = originalPlayer.m_name; 
return *this; 


142 CHAPTER 12: Copying and Assigning Data to Objects 


nin O O 


void SetName(const std::string& name) 


{ 
m_name = name; 
} 
const std::string& GetName() const 
{ 
return m_name; 
} 
void SetCurrentRoom(const Room* pCurrentRoom) 
{ 
m_pCurrentRoom = pCurrentRoom; 
} 
const Room* GetCurrentRoom() const 
{ 
return m_pCurrentRoom; 
} 


F; 


An assignment operator is passed a constant reference to the object that is being assigned from. 
This allows you to copy all of the relevant fields to the object being assigned to. There is a major 
difference between a copy constructor and an assignment operator. A copy constructor is invoked 
when a new object is being created and can be initialized by copying from an existing object. The 
assignment operator is invoked when assigning to an already existing object. Listing 12-4 shows an 
example. 


Listing 12-4. Invoking an Assignment Operator 


Player newPlayer; 
newPlayer = m player; 


You can now use general arithmetic assignment operators with your classes so long as you remember 
to overload the assignment operator appropriate for assigning to your class as in Listing 12-3. 


Move Semantics 


Move semantics are useful when dealing with some more complex C++ code. We’ll cover some 
cases where move semantics are useful later in this book, but for now I'll show you how you can 
add move constructors and move assignment operators to your classes. Move semantics differ 
from normal copy constructors and assignment operators in that they operate on rvalue references. 
An rvalue reference is denoted in C++ using a double ampersand. These rvalue references can only 
be used when working with temporary objects, which can be created under many circumstances 

in C++, such as when returning objects from functions by value. Listing 12-5 shows a move 
constructor for the Player class. 
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Listing 12-5. The Player Move Constructor 
Player(Player&& tempPlayer) 
{ 


m_pCurrentRoom = tempPlayer.m_pCurrentRoom; 
m_name = tempPlayer.m_name; 


tempPlayer.m_pCurrentRoom = nullptr; 
m_name.clear(); 


} 


The double reference symbol in a move constructor means that the reference being passed in is an 
rvalue reference. rvalue references occur when passing temporary objects into methods. This occurs 
often when using STL containers, which we'll be looking at in Part 3 of this book. It’s also important 
to clear the data from the object passed into the move constructor, and you’ll see why this is the 
case when we look at memory management in Part 5. A move assignment operator can also be 
added to your classes. Listing 12-6 shows how to do this. 


Listing 12-6. A Move Assignment Operator 
Player& operator=(Player&& tempPlayer) 


if (this != &tempPlayer) 


{ 
m_pCurrentRoom = tempPlayer.m_pCurrentRoom; 
m_name = tempPlayer.m_name; 
tempPlayer.m_pCurrentRoom = nullptr; 
m_name.clear(); 
} 
return *this; 
} 
Summary 


This short chapter has introduced you to the methods that can be added to classes to allow you to 
pass data around in your programs. These are not particularly useful as stand-alone procedures, 
but they will be very useful in the next part of this book when we look at the STL. The STL provides 
us with containers to store many objects in data structures and we will be using copy constructors, 
assignment operators, and move semantics liberally throughout that entire part of the book. 


You have seen how copy constructors allow you to make copies of classes. This occurs most often 
when passing objects into functions by value; however, you will usually be satisfied with passing 
most objects by a const reference to avoid the cost of invoking the copy constructor. You’ve 

also seen how you can overload assignment operators to copy data from one object to another 
preexisting object. Finally, you saw how move semantics can be added to your classes. You’ll see 
better how these are useful later in this book. 


Part 


The STL 


Modern programming languages come with many features, data structures, and algorithms out 
of the box. C++ is no exception. The Standard Template Library (STL) provides interfaces to a 
preexisting library of functionality that will allow you to write better programs faster. 


The STL provides you with tools to manage collections of objects, execute algorithms on those 
collections, and learn how to best structure the data in your applications. 


This part of the book will help you learn the differences between the different STL containers and 
when to use each in your programs. You'll also see the string class in action, which will help you 
work with strings in a much easier manner than using raw C strings. 


The STL also provides excellent exposure to the syntax required to use templates in your programs. 
This will be very useful in the next part of the book when you learn how to create your own 
templates. 


Chapter 


The STL String Class 


The next few chapters of this book are going to introduce you to the Standard Template Library 
(STL). The STL contains classes that you can use to manipulate strings, store objects, and access 
them using several different patterns. The STL also provides iterators to traverse collections and 
algorithms for carrying out different types of operations on your data sets. You have already been 
using the STL string class throughout this book. This chapter looks at the different methods that 
the STL provides for working with classes and points out some of the reasons why using this class is 
more desirable than dealing with raw C strings. 


Standard string and basic_string 


The STL should give you a brief clue that we will be using templates of classes to create concrete 
types. You'll learn how to create your own templates in Part 4 of this book when we cover the 
Generic Programming Paradigm. For now, all you need to know is that templates behave exactly as 
their name suggests and provide a blueprint for the compiler to create specific classes. 


The string class is implemented in exactly this way. The template basic_string is used to generate 
four different types of standard strings. Listing 13-1 shows how the STL uses type aliases to 
generate these types. 


Listing 13-1. The STL basic_string Aliases 


using string = basic_string<char>; 

using u16string = basic_string<char16_t>; 
using u32string = basic_string<char32_t>; 
using wstring = basic_string<wchar_t>; 


There are a few operations happening here, so l'Il talk you through the important parts. The first 

thing to notice is how you can create template specializations. The basic_string<char> is creating a 
specialization of the basic_string template using the char data type. As you have seen, a char is a 
data type that can store a single byte of data. Listing 13-1 also creates specializations of basic_string 
using char16_t, char32_t, and the wchar_t data types. Two bytes are generally used to store wchar_t 
data types and always used to store char16_ t and four bytes are used to store char32_t data. 
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The other important aspect of the lines in Listing 13-1 is the fact that they create type aliases. You’ve 
been using the string alias already in this book. What the alias has done is allow you to use the 
string keyword when declaring string variables rather than having to type the full typename, which 
would be basic_string<char>. 


The concepts of template specialization and type aliases are all you need to understand about 
templates to be able to use the functionality provided by the STL. 


Note Type aliases are a modern feature of C++11. If your compiler does not support type aliases, you can 
use an older style. The code typedef basic_string<char> string; would serve a similar purpose. 


Constructing Strings 


The basic_string template provides many different types of constructors for creating instances of 
strings. Listing 13-2 shows how to create empty strings. 


Listing 13-2. An Empty String 


string emptyString; 
Listing 13-3 shows how you can create strings from a C-style string literal. 


Listing 13-3. A Literal String 


string literalString{ "This is a literal string!" }; 
You can also use a copy constructor to copy a string as shown in Listing 13-4. 


Listing 13-4. Copying a String 


string copiedString{ literalString }; 


This example has copied the literalString from Listing 13-3 into copiedString. This means that 
both literalString and copiedString contain the literal "This is a literal string!". They are 
both still discrete copies, so any changes you make to one do not affect the other. 


It’s also possible to initialize new strings from substrings; that is, to specify the specific start 
position and optionally the number of characters you wish to copy. Listing 13-5 shows the possible 
substring initializers. 


Listing 13-5. Initializing Strings with Substrings 


string listerStartPosition{ "This is a literal string!", 5 }; 
string listerStartPositionAndNumber{ "This is a literal string!", 5, 4 }; 


This example will result in LiteralStartPosition containing "is a literal string!" and 
literalStartPositionAndNumber will contain "is a". This is because the start position 5 is passed into 
both and in the second line we also specify that we would only like to copy the next four characters. 
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Working with Strings 


Once you have your data in a string object there are many different methods provided by basic_string 
that operate on the internal string data. The first set of useful functions allows you to ask and alter the 
string’s size and capacity. Table 13-1 shows the different methods supplied to work with the size of 
your string data. 


Table 13-1. basic_string Capacity Methods 


Method Description 

n=str.size() The number of letter elements in the string. 

n=str.length() Returns the same value as size(). 

n=str.max_size() The maximum possible string length. 

str.resize(n, c) Resizes the string. If the size is shorter than before, trailing characters are lost. If the 
size is longer than before, the new elements are initialized to the supplied character. 

str.resize(n) Calls str.resize(n, '\o') 

n=str.capacity() Returns the amount of memory allocated to store the string. 

str.reserve(n) Asks the string to increase the capacity to at least the supplied value. 


str.shrink_to fit() | Asks the string to reduce the capacity to just large enough to fit the size of the string. 
Some implementations of basic_string allocate more memory than is needed in case 
you try to add more to the string later. 


str.clear() Removes the current string data and reduces size to 0 but might leave capacity 
unchanged. 
b=str.empty() Returns true if size() == 0. 


Note: str is a string, n is anumber, c is a single character, and b is a boolean. 

This set of methods allows you to determine the size of your strings and the amount of memory 
being used by your string data. They also allow you to modify the memory requirements of your 
strings. Table 13-2 shows the methods you can use to modify your strings. 


Table 13-2. basic_string Modifiers 


Method Description 

str&=str.append(str) Append a string to the current string. 
str&é=str.append(str, pos, n) Append a substring starting at pos and n length to a string. 
str&é=str.append(cstr*) Append a C-style string literal to a string. 
str&=str.append(cstr*, n) Append n characters from a C-style string. 


Note: str is a string, cstr is a C-style string, c is a single character, and n is a number. 
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The methods in Table 13-2 show how you can append data to the end of an existing string. Each 
of the types also have a corresponding overloaded += operator, meaning that you can append to a 
string using code that resembles a normal arithmetic equation. 


The same types are also supported by the assign methods. Where append adds the supplied text to 
the end of your strings, assign replaces the data in your string with the supplied text. The assign 
methods are also implemented as the overloaded = operators. 


It’s also possible to access individual characters in our string using the array operator. str[0] would 
return the first character of a given string. It’s rare that you’ll want to access string data in this 
manner, and the next section covers a more useful way of traversing string data. 


Accessing String Data Through Iterators 


Iterators are going to become second nature to you as you work with the STL. All of the data 
containers supplied by the STL use the iterator pattern to supply you access to their individual 
elements. In the case of a string, an iterator gives access to a single character in your string. You can 
use iterators to traverse the data structure forward and backward. Listing 13-6 shows how you can 
loop over a string and print out the individual characters using iterators. 


Listing 13-6. Looping over a String 


void StringIterators() 


{ 
using namespace std; 
string myString{ "This is my string!" }; 
for (string::iterator iter = myString.begin(); iter != myString.end(); ++iter) 
cout << *iter << endl; 
} 
} 


The type for a string iterator is string::iterator. The methods begin and end return iterators that 
represent the beginning and end of our string data. The iterator we declare is named iter and we 
can move to the next element in the string using the increment operator. You can see that we must 
dereference iter to gain access to the data that is contained at the current position in the string. 
It’s also possible to decrement string: :iterator and you can see this in action in Listing 13-7. 


Listing 13-7. Decrementing string: :iterator 


for (string::iterator iter = myString.end()-1; iter != myString.begin(); --iter) 


cout << *iter << endl; 


} 


A better way to move backward through a string from end to beginning is to use string: :reverse_ 
iterator, which you can see in Listing 13-8. 
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Listing 13-8. string: :reverse_iterator 


for (string::reverse iterator iter = myString.rbegin(); iter != myString.rend(); ++iter) 


cout << *iter << endl; 


} 


The reverse_iterator is used with the methods rbegin and rend. Listing 13-9 shows the const 
versions of the iterators. 


Listing 13-9. Const Iterators 
for (string::const_iterator iter = myString.cbegin(); iter != myString.cend(); ++iter) 


cout << *iter << endl; 


} 


for (string::const_reverse iterator iter = myString.crbegin(); 
iter != myString.crend(); 
++iter) 


{ 
} 


cout << *iter << endl; 


Constant iterators are different from normal iterators in that you cannot modify the data to which they 
are pointing. Listing 13-10 shows how you could have modified the data pointed to by an iterator. 


Listing 13-10. Using Iterators to Alter Data 


for (string::iterator iter = myString.begin(); iter != myString.end(); ++iter) 


*iter = 'a'; 
cout << *iter << endl; 


} 


This simple example shows how you can modify data through an iterator dereference. Trying to 
assign through a const_iterator would result in a compile error. If your loops are designed to only 
read from your collection using an iterator you should prefer a const_iterator to ensure that no 
mistakes are made that can alter your data. 


There is also a more modern way of looping over all of the elements in an STL collection, the 
range-based for loop. You can use a range-based for loop with any C++ type that has a begin and 
end method; this includes classes that you write yourself. Listing 13-11 shows a range-based for 
loop with our string. 


Listing 13-11. Range-Based for 


for (char &letter : myString) 
{ 


} 


cout << letter << endl; 
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This for loop allows you to alter the data at each element as the element is accessed through a 
reference variable. You can avoid this by making the type a const variable as shown in Listing 13-12. 


Listing 13-12. Range-Based for with Constant Access 


for (const char &letter : myString) 
{ 


} 


cout << letter << endl; 


A better way to write your range-based for loops might be to use the auto keyword as in Listing 13-13. 


Listing 13-13. Using auto in Range-Based for Loops 


for (auto &letter : myString) 


{ 
letter = 'a'; 
cout << letter << endl; 
} 
for (const auto &letter : myString) 
{ 
cout << letter << endl; 
} 


If you were to do this, you would change the type of string template specialization without being 
required to change all of your range-based for loops. Listing 13-14 shows how auto can also be 
useful for standard for loops. 


Listing 13-14. Using auto with Standard for Loops 


for (auto iter = myString.begin(); iter != myString.end(); ++iter) 


{ 
cout << *iter << endl; 
} 
for (auto iter = myString.cbegin(); iter != myString.cend(); ++iter) 
{ 
cout << *iter << endl; 
} 


The auto keyword in these examples automatically detects if the iterator is constant or not. 
This saves you from having to use the correct type of iterator in your definitions, makes it easier to 
switch between string types, and still gives const correctness when using cbegin and cend. 


Searching Within Strings 


The C++ STL supplies methods to allow you to search for data within strings. Listing 13-15 gives 
you an example of the find method in action. 


CHAPTER 13: The STL String Class 153 


Listing 13-15. The string: : find Method 


string myString{ "This is my string!" }; 
void FindInString(string myString) 


{ 
size_t found = myString.find("is" 
if (found != string: :npos) 
{ 
cout << "\" is\" found at position: " << found << endl; 
} 
found = myString.find("is", found+1) ; 
if (found != string: :npos) 
{ 
cout << "is found at position: " << found << endl; 
} 
} 


The example in Listing 13-15 shows two different versions of found. The first finds the first instance 
of “is” in the string and returns the index where it can be found. This first call will return 2 for the is 
that makes up part of This. The find method will return the constant value string: :npos if it fails to 
find the supplied data. We can then call find again and pass in the start position for the search. 

In our example we pass in the position of the previously found instance and add 1 to skip over 

it. This second call returns 5 when it finds the word is. The rfind method will carry out the same 
operation but search backward through the string and myString.rfind("is") would return 5. rfind 
can also take a position value to start working back from. 


It’s also possible to search for a single character in a supplied set using find first_of. Listing 13-16 
shows this method in action. 


Listing 13-16. The string: :find_first_of Method 


found = myString.find_first_of("msg"); 
if (found != string: :npos) 


{ 
} 


cout << "is found at position: " << found << endl; 


This method does not look for the entire phrase msg; instead it looks for m, s, and g individually. 
In our example the first of these characters is the s in This and therefore the method returns 3. 
There are also complementary methods find_last_of, find_first_not_of, and find_last_not_of. 
These methods behave as you would expect: find_last_of finds the last character in the supplied 
set, find_first_not_of finds the first character not in the set, and find_last_not_of finds the last 
character not in the set. 


Formatting Data with stringstream 


If you’ve used the C or C++ programming languages in the past, you might be familiar with the 
printf method for formatting string data. Even today many C++ programmers still use this older 
C-style method of formatting data for use within strings. This book, however, covers the more 
modern method for formatting string data, using iostream modifiers. You have already seen some 
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examples of iostream modifiers in action. One of the most common modifiers is std::endl and 
earlier in the book you also used the std: :hex and std: :showbase modifiers with cout. Listing 13-17 
shows a method that uses a stringstream to format data into a string. 


Listing 13-17. stringstream Modifiers 


#include <iostream> 
#include <sstream> 
#include <iomanip> 
#include <ios> 

void StringStreamExample() 
{ 


stringstream myStringStream; 


myStringStream << "Hi" << endl; 


cout << "width: " << myStringStream.width() << endl; 
myStringStream << 123 << endl; 

myStringStream << setw(10) << 123 << endl; 
myStringStream << setw(0) << 123 << endl; 


myStringStream << 123.567 << endl; 

myStringStream << setprecision(4) << 123.567 << endl; 

myStringStream << fixed << setprecision(2) << 123.567 << endl; 
myStringStream << defaultfloat << setprecision(0) << 123.567 << endl; 


myStringStream << 110 << endl << showbase; 
myStringStream << hex << 110 << endl; 
myStringStream << oct << 110 << endl; 
myStringStream << dec << 110 << endl << noshowbase; 


string myString = myStringStream.str(); 
cout << myString; 


} 


You can see in Listing 13-17 that you can use a stringstream object in the same way we have been 
using the cout object to write to the console window. This means that all of the modifiers that are 
available to cout are also available to stringstream and later in the book you'll see how they’re also 
available when writing and reading files. 


The specific examples of modifiers that you can see in Listing 13-17 are the setw, setprecision, 
fixed, defaultfloat, showbase, noshowbase, hex, oct, and dec modifiers. The setw modifier ensures 
that the number specified is the minimum number of characters written to the stream. In this case 
we will write the value 123 and 7 padding characters, in this case spaces, into the stream. We clear 
the width by setting the value of the width back to 0. 


The setprecision modifier is used to round numbers. This will round floating point values. The value 
of 4 in the example will round 123.567 to 123.6. When we use the fixed modifier, we are telling 

the stream to fix the number of decimal places using the value set by setprecision. Therefore 

<< fixed << setprecision(2) will round our number to 123.57. The last line related to floating point 
values removes the fixed modifier by reinstating the defaultfloat setting and setting the precision 
back to its default value of 0. 
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We can also alter the way decimal numbers are represented by outputting them as hexadecimal 
values, octal values, or back to decimal values. We can also use the showbase and noshowbase 
to include or remove the 0x appendage on hexadecimal numbers or the 0 appendage on octal 
numbers. 


The last operation shown with the stringstream is to obtain a string representation of the data 
we have created. This is necessary, as we cannot use a stringstream object as an input to cout. 
The str method is provided by the stringstream class for this purpose. 


Summary 


This chapter has given you an introduction to the STL string library. This is the first time you have 
had to consider how C++ uses templates to specialize generic code into specific implementations. 
This process is used throughout the STL and the string class is a perfect introduction to this 
concept. You’ve used strings in the examples contained in this book from the very beginning, which 
goes to show the flexibility and power of the ability of C++ ability to have generic code be hidden 
from programmers. Understanding how templates can be used in such a manner will give you an 
advantage over many programmers, as there are many who believe templates are too complex to be 
used in day-to-day code. 


You’ve seen in this chapter how you can access and manipulate string data in C++ programs using 
the methods provided by STL rather than using the older C-style string methods. This can lead to 
your code being more robust, as the string class is a first class type in C++. As you’ve seen, C-style 
strings are nothing more than arrays that end with a null terminator and rely on convention to ensure 
that they are implemented properly. The string class avoids this problem by enforcing the proper 
null termination of strings without requiring the user to remember to accommodate them. 


Another advantage to C++ strings is that the storage for string data is automatically handled by the 
class. When appending C-style strings, you would be responsible for allocating new arrays large 
enough to hold both strings and ensuring that the data are copied properly, deleted properly, and 
null terminated properly. This can lead to length functions when a single line of C++ code can carry 
out the same operation. Thanks to the nature of C++ and the STL we do not need to look at memory 
management topics until much later in this book. 


You’ve also seen in this chapter that STL containers can be accessed through iterators. This is a 
common design pattern in C++ and all STL containers use the same access method. You will see 
this in action throughout the rest of this book, including in the next chapter, where we look at the 
STL array and vector containers. 


Chapter 


STL Array and Vector 


You saw in Chapter 13 that the STL provides different types of string classes by specializing a 
template to create different implementations. This is where the template part of the STL comes from. 
The STL string classes are what we call containers, because they store string data. In this chapter 
you will see two more of the STL’s containers in the array and vector templates. 


STL’s array class can be used in place of the built-in array types that you have seen earlier in 

this book. This allows you to use arrays in the same way you would use other STL containers; for 
example, the STL array template provides iterator access to the array elements. The size of an 
STL array is still determined at compile time. Sometimes you might not know how many elements 
you will need to store in your collection, and this is where the vector template is useful. A vector 
stores any number of elements and can dynamically grow and shrink to accommodate more or less 
items at runtime. Let’s take a look at how these templates can be used. 


The STL Array Template 


Before we get into STL arrays, it is worth remembering how to define a traditional C-style array in 
C++, as shown in Listing 14-1. 


Listing 14-1. A Traditional C-Style Array 


const unsigned int ARRAY SIZE = 5; 
int oldArray[ARRAY SIZE] = { 0, 1, 2, 3, 4 }; 


Hopefully you find that familiar. Listing 14-2 shows how you can construct an array holding the same 
values using a C++ STL array container. 


Listing 14-2. An STL array Container 


const unsigned int ARRAY SIZE = 5; 
std: :array<int, ARRAY SIZE> newArray = { 0, 1, 2, 3, 4 }; 
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As you can see, the syntax changes a bit when using an STL array. You can see the now familiar 
template specialization syntax at work. The first template parameter tells the compiler that you 
would like to use the int type for storing the values in our array. The second parameter then tells 
the compiler how many elements we would like our array to hold. Now that you know how to create 
arrays using the STL array template, | can show you some examples of why this is desirable over 
using standard C-style arrays. Listing 14-3 shows several examples of different ways you can use to 
find elements in an array. 


Listing 14-3. Searching in an array 


using MyArray = std::array<int, ARRAY _SIZE>; 
void FindInArray(MyArray myArray) 


{ 
for (unsigned int i = 0; i < ARRAY SIZE; ++i) 
if (myArray[i] == 2) 
{ 
cout << "Found: " << myArray[i] 
<< " at position: " << i << endl; 
} 
} 
for (auto iter=myArray.begin(); iter!=myArray.end(); ++iter) 
{ 
if (*iter == 2) 
cout << "Found: " << *iter << endl; 
} 
} 
for (auto& number : myArray) 
if (number == 2) 
{ 
cout << "Found : " << number << endl; 
} 
} 
MyArray::iterator found = find(myArray.begin(), myArray.end(), 2); 
if (found != myArray.end()) 
{ 
cout << "Found : " << *found << endl; 
} 
} 


The very first line in Listing 14-3 creates a type alias for our array type. You get a benefit when using 
type aliases with template specializations in two ways. First it means that you do not have to type 
out the full template specialization each time you wish to refer to that type. It also means that if you 
need to change the type that you only have to change it in the type alias and it will apply to all of the 
places where the type alias is used. The alias MyArray can now be used in place of std: :array<int, 
ARRAY_SIZE> everywhere in our code. 
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The first for loop in Listing 14-3 shows the standard method for looping through array elements. 
This syntax is the same whether looping over a C-style array or when using the STL array template. 


The second loop uses iterators in the same manner as you saw when looping over the characters in 
your strings in Chapter 13. You can then also see the range-based for loop used. 


The last example is something a little different: It uses an STL algorithm to find the element we 
would like in the array. You have already seen that the STL provides containers that you can use to 
store elements and now you can see that the STL also provides algorithms that operate on those 
containers. This algorithm is the find and it works by taking an iterator marking the beginning of 

a range and an iterator marking the end of a range as well as the value we wish to search for. The 
beginning and end iterators supplied to find do not have to be the beginning and end iterators 
from your collection; they could have been the second and third iterators from our array. The find 
function returns an iterator to the first element that matches the supplied value. If no values match, 
it returns the end iterator that you passed in. You can see this result tested in the if statement 
following the find call. 


The STL Vector Class 


The STL array takes a size parameter that tells the compiler exactly how big we need the array to 
be before our program ever runs. However, we might not always know how many elements we will 
need. When this is the case, we can use the STL vector template. Listing 14-4 shows how you can 
specialize vector. 


Listing 14-4. Specializing STL vector 


using namespace std; 

using MyVector = vector<int>; 
MyVector myVector = { 0, 1, 2 }; 
myVector.push_back(3); 
myVector.push_back(4); 


Listing 14-4 shows that you can add new values to a vector even after it has been initialized. The 
vector automatically resizes itself if it needs more memory to store the new element. You can 

also insert elements into other places in a vector and erase elements. Listing 14-5 shows how this 
is done. 


Listing 14-5. vector insert and erase 


MyVector::const_iterator iter = myVector.cbegin() + 1; 
myVector.insert(iter, 5); 
myVector.erase(iter); 


The insert and erase methods take a constant iterator to the position where we would like the insert 
and remove operator to take place. The insert shown in Listing 14-5 would result in our vector 
storing the values 0, 5, 1, 2, 3, 4 in that order, and the erase would remove from the same location, 
which would remove the 5. It does not remove the 1, as the iterator points to the second location in 
the vector, which is occupied by 5 after the insert. Each element after that location has moved one 
position to the right. 
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You’ll be glad to know that thanks to the standardization of the STL, the loops we looked at in 
Listing 14-3 with the STL array also work in exactly the same way for the vector template. Listing 14-6 
shows these vector loops. 


Listing 14-6. Finding Values in a vector 


void FindInVector(MyVector myVector) 


for (unsigned int i = 0; i < myVector.size(); ++i) 
if (myVector[i] == 2) 
cout << "Found: " << myVector[i] 
<< " at position: " << i << endl; 
} 
} 
for (auto iter = myVector.begin(); iter != myVector.end(); ++iter) 
if (*iter == 2) 
{ 
cout << "Found: " << *iter << endl; 
} 
} 
for (auto& number : myVector) 
{ 
if (number == 2) 
cout << "Found : " << number << endl; 
} 
} 
MyVector::iterator found = find(myVector.begin(), myVector.end(), 2); 
if (found != myVector.end()) 
{ 
cout << "Found : " << *found << endl; 
} 
} 


Sorting Arrays and Vectors 


The STL provides many different algorithms that can operate on your data, and one of the more 
useful is sort. This algorithm does exactly what you think it might: It sorts elements into order. The 
sort function takes an iterator to the first and last elements of the range we would like to sort and 
can optionally take a function to determine the sort order. Listing 14-7 shows this in action. 
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Listing 14-7. std::sort 


bool Descending(int first, int second) 


{ 
return first > second; 
} 
void SortVector() 
{ 
MyVector myVector = { 0, 1, 2, 3, 4 }3 
sort(myVector.begin(), myVector.end(), Descending); 
for (auto& value : myVector) 
{ 
cout << value << endl; 
} 
sort(myVector.begin(), myVector.end()); 
for (auto& value : myVector) 
{ 
cout << value << endl; 
} 
} 


The first call to sort reverses the order of our vector. This is achieved by the Descending function. 
If this supplied function returns true, the elements are left in the current order; if it returns false, 
the elements are switched. A practical example would be the elements 0 and 1. When these two 
numbers are compared, 0 > 1 is false; therefore the elements would be switched to 1, 0, which is 
what we want. 


The second sort call does not take a comparison function as a parameter, so by default this would 
use the comparison first < second. 


Summary 


The fact that the code in Listings 14-3 and 14-6 is identical other than for the types passed into 
the function is a perfect example of the flexibility of the STL. The STL containers are written to be 
interchangeable and the correct container should be used for the correct purpose. 


You have seen in this chapter that you can replace your use of C-style arrays with STL array with 
no impacts on any of the code you are writing. You can still use the [ ] operator to access values. 
However, the STL implementation of array also allows you to use the powerful iterators and 
algorithms that it supplies to coexist with the container classes. 


The array should be used any time you have a collection of values to store and you know the exact 
number you will need at compile time. If you need a collection that can grow or shrink as your 
program runs, you should use the vector. 
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Both of these containers are excellent at storing sets of data that you plan to access in a linear 
fashion as the data is stored together in memory. They do have some drawbacks, however. The 
array container cannot be resized, which means you need to know at compile time how many 
elements you would like to store. The vector stores its data internally inside an array. When you add 
elements and the vector requires more room it will create another array, usually double the size of 
the current array and copy all of the elements from the old array to the new array. In the next chapter 
we will look at another linear STL container, the List, which can be used when you need to add and 
remove elements to a linear collection often without having to worry about the resize performance 
required by a vector. 


Chapter 


STL List 


The STL list template is another linear data collection. The previous chapter briefly mentioned 

the difference between array, vector, and list, and this chapter goes into more detail about why 
and when you would use these different collections. The main point to remember is that you should 
always use the correct tool for the job at hand. Video games rely on extracting the most performance 
possible from the target hardware, and access times to data in collections is a major bottleneck with 
modern processors. This chapter shows you how to build your own list class in an effort to help 
you understand the difference between arrays and linked lists. 


Understanding Array and List Memory Layouts 


An array is a very efficient method for storing a fixed number of elements. The compiler will pack 
each of the elements in your array into a contiguous block of memory. You can see this contiguous 
memory in action when you work with pointers to arrays and you move between array elements 
using pointer arithmetic. As integers are usually 4 bytes in size, you can move from one integer to 
the next in an array by adding 4 bytes to the current memory address for the element you have a 
pointer to. The same happens when we are working with arrays of any given type: The compiler 
can automatically work out the number of bytes required to represent the type and move between 
elements efficiently. 


This contiguous memory access suits modern processors due to their use of cache memory. A 
processor can calculate arithmetic and other instructions at a much faster rate than it can read from 
memory. To combat this, processors read from memory in blocks known as cache lines into an 
on-die fast memory. It’s not uncommon for processors to read in blocks of 64 or 128 bytes. Even if 
you need to read only 4 bytes of memory to access an integer, the processor will read a full cache 
line. This means that array accesses are very efficient on modern processors because whole chunks 
of an array can be read into the processor’s cache when you access the first element in the array. 
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The problem with arrays arises when you do not know exactly how many elements you need at 
compile time. Compilers require you to inform them of how many elements will be in your array so 
that they can allocate the proper memory for storage. The vector class provides a resizable array, 
but this is a little bit of a trick. The vector works by providing more storage than you actually need 
when the vector is initialized. If you add more elements than the vector currently has capacity for, 
the template requests a new array from the operating system, which is usually double the size of the 
current capacity. The vector then copies all of the elements from the old array into the new array. 

If you are doing this resizing often, a vector can prove to be a fairly slow container. 


A linked list, on the other, hand does not store its elements in a contiguous block of memory. 
Instead each element in the list stores a pointer to the next and previous elements in order. This 
provides a container that is resizable and can provide for fast inserting and removal of elements 

in the list. However, because the list is noncontiguous in memory, the processor cannot use its 
cache as effectively when traversing the list. Many C++ courses like to teach the list, as it’s a good 
introduction to data structures. Unfortunately for game developers, the list is rarely a good choice 
for code that you would like to perform as efficiently as possible due to the cache implications. This 
chapter shows you how to create your own list and how to use the STL list, but you should always 
keep the memory and cache implications in mind. 


Building a List Class 


Building a linked list is a fairly straightforward process once you understand how to use pointers. 
If you need to recap what pointers are and how they work, | suggest that you reread Chapter 4 
before continuing. Listing 15-1 shows the ListNode class. 


Listing 15-1. ListNode 


class ListNode 


{ 

private: 
void* m Data = nullptr; 
ListNode* m_Last = nullptr; 
ListNode* m Next = nullptr; 

public: 


ListNode(void* data) 
: m Data{data} 


{ 
} 
void* GetData() 


return m_ Data; 


} 


void SetLast(ListNode* last) 
{ 


} 


m_Last = last; 
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O- 


ListNode* GetLast() 


{ 

return m_Last; 
} 
void SetNext(ListNode* next) 
{ 

m_Next = next; 
} 
ListNode* GetNext() 
{ 

return m_Next; 
} 


Js 


Listing 15-1 represents a very basic implementation of a double linked list. A single linked list would 
only have pointers to the next element in the list, but our ListNode class has pointers to both the 
next and the previous nodes. ListNode also stores a void* to the data that the node represents. 

A better way to implement this would have been to create our own templates, and I’ll begin to cover 
how to do this in Part 4 of this book. You’ll get a better appreciation of how the class operates by 
looking at some code that puts it to use, such as in Listing 15-2. 


Listing 15-2. Using ListNode 


void OurList() 
{ 


unsigned int firstData = 1; 
ListNode first(&firstData) ; 


unsigned int secondData = 2; 
ListNode second(&secondData) ; 


unsigned int thirdData = 3; 
ListNode third(&thirdData) ; 


first.SetNext(&second) ; 


second. SetLast(&first) ; 
second. SetNext (&third) ; 


third.SetLast (&third) ; 


for (ListNode* iter = &first; iter != nullptr; iter = iter->GetNext()) 

{ 
unsigned int* number = static_cast<unsigned int*>(iter->GetData()); 
cout << *number << endl; 
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The OurList function creates three nodes to add to our list, each storing an unsigned int to illustrate 
the result when we loop over the list. What you can see is that the m Next pointer of first is set to 
point to the ListNode second. In turn second points back to first and forward to third and third 
points back to second. 


The for loop in the function then traverses the list and prints the value stored by each. It does this 
by faking an iterator to the list. In fact, all we do is get a pointer to first, then have the iter pointer 
be updated to iter->GetNext() each time the loop iterates. Eventually we get to third’s m_ Next 
pointer, which will be set to nullptr, and the loop ends. At this point you could delve deeper into 
implementing your own lists; however, | would recommend sticking to the STL list template. All of 
the features you might like in a list have already been implemented and the STL list is compatible 
with all of the iterator types and algorithms that also support other STL containers. 


The STL List Template 


You will not be surprised to hear that STL’s list syntax is very similar to that of vector. You can see 
this in Listing 15-3. 


Listing 15-3. STL list 


using namespace std; 
using MyList = list<int>; 


MyList myList = { 0, 1, 2 }; 
myList.push_back(3); 

myList.push_back(4); 

MyList::const_iterator iter = myList.cbegin(); 
++iter; 

Iter = myList.insert(iter, 5); 
myList.erase(iter) ; 


There is only a single difference between this code when using a list compared to using a vector: 
list iterators cannot be modified using the + and - operators. Instead we get the iterator and then 
use the ++ or -- operators to move to the position in the list where we would like to insert or erase 
elements. The iterator we have also remains pointing to the same element after we insert into 
myList. To be able to remove the correct element we had to catch the new iterator returned by the 
insert method. 


The last major difference in usage between list and vector is that the [ ] operator is not supported 
by list. This makes sense if you think back to the way that these containers store their elements in 
memory. Generally vector is implemented using arrays internally, which means that it’s easy to use 
the [] operator and pointer arithmetic to offset into the array to get the proper element for a given 
index. This operation doesn’t make any sense for a list where the underlying implementation does 
not store elements contiguously in memory. 


STLs list implementation supports all of the same iterator types and the find algorithm that we 
looked at in Chapter 14. The sort function is a little different and is implemented as a method rather 
than a stand-alone function. Listing 15-4 shows the list: :sort method in action. 
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Listing 15-4. list::sort 


bool Descending(int first, int second) 


{ 
return first > second; 
} 
void SortList() 
{ 
MyList myList = { 0, 1, 2, 3, 4 }; 
myList.sort (Descending) ; 
for (auto& value : myList) 
{ 
cout << value << endl; 
} 
cout << endl; 
myList.sort(); 
for (auto& value : myList) 
{ 
cout << value << endl; 
} 
} 


The implication of this difference is that you cannot sort ranges of values within the list; you can only 
sort the entire list at once. 


Summary 


This chapter has shown you how you can use the STL list template. | began by discussing the 
differences between the way array, vector, and list store their elements in memory, along with a 
basic explanation of how these differences affect the performance of the different containers. 


I then covered how you could create your own very basic list implementation to help you 
understand how the list behaves differently than an array or vector at a code level. Finally we 
looked at how the STL list shares some iterator and algorithm types with array and vector, but 
also how it differs with respect to the array operator and the sort method. 


The next chapter covers four more STL containers: set, map, unordered_set, and unordered_map. 
These containers provide slight variations on the binary search tree and hash map data structures 
and are very useful when you need to sort and access very large sets of data. 


Chapter 1 6 


STL’s Associative Containers 


All of the STL containers you have seen so far have stored individual data elements. In this chapter 
you will be introduced to associative containers. These containers associate a key with the data 
values that you are inserting. In the case of the map and unordered_map containers, you are required 
to supply a value to use as the key, whereas the set and unordered_set containers automatically 
generate keys from the data you supply. l'Il explain the differences between each of these containers 
as | work through some examples in this chapter, beginningwith the set container. 


The STL set Container 


You won’t be surprised to find out that a set is a template class and you are required to specialize 
the set container to store the types you require. Listing 16-1 gives an example of how you can 
specialize the set template. 


Listing 16-1. Specializing set 


using namespace std; 
using MySet = set<int>; 


Once you have specialized a set template you can initialize a container in the same manner as other 
STL containers. Listing 16-2 shows how you can create and add values to a set. 


Listing 16-2. Initializing and Adding to set Containers 


MySet mySet = { 2, 1, 0 }; 
mySet.emplace(4); 
mySet. insert (3); 


There are two important aspects of Listing 16-2 to which you should pay particular attention. The first is 
the emplace method used. This method has the same result as the insert method in that the value will be 
added to the set. However, emplace is actually faster at achieving this than insert in some circumstances. 
It achieves this speed improvement by avoiding a copy construction when using a set with class types. 
You should always use emplace rather than insert with all containers when it is available. 
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The second important aspect is the values we are adding to the set. The first curious feature is that 
the numbers are not in order. A set will automatically sort the values as they are added, which is 
one of the reasons you might consider using a set rather than an array, vector, or list. After the 
final line that inserts the value 3, the set will contain the numbers O0, 1, 2, 3, and 4 in order. The other 
important feature of the values is that they are all unique. If we had tried to add duplicate values 

to the set, they would be ignored. This is important to remember and is different to the behavior of 
array, vector, and list, which would allow you to add duplicate values. 


The sample code that accompanies this chapter shows examples of using a set with iterators and the 
STL find algorithm. This code is identical to the iterator-based and range-based for loops that you 
have seen with previous containers in Chapters 14 and 15. Hopefully you have begun to get the hang 
of how to access elements in STL containers. 


The next container | will show you is map. A map is conceptually similar to a set, but it requires that 
you provide a key along with your data. 


The STL map Container 


All of the containers you have seen so far take a single value and store these individual values at 
discrete locations. The map container is different: It requires that you supply a key along with the 
value to be stored. You then use this key to retrieve the value from the map. When inserting elements 
into a map, you are required to supply the values using the pair template. Listing 16-3 shows the 
template specializations for the map and pair templates. 


Listing 16-3. Specializing map and pair 


using namespace std; 
using MyMap = map<int, string>; 
using MyPair = pair<int, string>; 


The map and the pair templates are supplied matching parameters to ensure that we are adding the 
correct types to the map. If we tried to supply the wrong types to a map, the compiler would generate 
an error. 


You can see in Listing 16-4 just how we add elements to our map. 
Listing 16-4. Adding Elements to a map 
MyMap myMap = { { 2, "Two" }, { 1, "One" }, { 0, "Zero" } }; 


MyPair node{ 4, "Four" }; 
myMap. insert (node) ; 


myMap.emplace( 3, "Three" ); 


The definition of a map can take a list of pairs that should be in the map at the time of its creation. 
In this example we have added pairs representing the values Zero, One, and Two, along with their 
respective integer representations as keys. 
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The insert method requires the use of our pair template to add values to myMap. You can see 

that we first construct the MyPair object node with the key 4 and value Four. After this, I’ve added 
an example of the emplace method. You can see how it can be more efficient to use emplace 
compared with insert in this example. You can leave out the creation of the pair object and a 
subsequent copy from the pair into the map by using emplace. The map shares a property with set: 
Both containers sort their values as they are entered. A map container will sort the keys into order 
as the elements are entered. This is the reason you would use a map rather than a set. If you have a 
complex class that you would like to store objects of in a map then the sorting and retrieval of these 
objects would be more efficient if you supplied simple data types such as integers as keys. It would 
also be possible to store two objects that are identical into a map by giving both objects different 
keys, as only the keys in a map are required to be unique. 


Unsurprisingly, a map cannot be iterated with exactly the same code as some of the other containers, 
as it stores elements as key-value pairs and our loops must take this into account. Listing 16-5 
shows an example of how we can loop over all of the elements stored in a map. 


Listing 16-5. Looping over a map 


for (const auto& node : myMap) 
{ 


} 


cout << "First: " << node.first << " Second: " << node.second << endl; 


The for loop itself is the same and C++ has allowed us to abstract out the MyPair type by using the 
auto keyword in its place. You can access the key and value stored in a pair using the first and 
second variables. The first variable stores the key and second stores the value. 


The find method also supplies an iterator to a map that represents a pair element, as you can see in 
Listing 16-6. 
Listing 16-6. Using map: : find 


MyMap::iterator found = myMap.find(2); 
if (found != myMap.end()) 
{ 


} 


cout << "Found First: " << found->first << " Second: " << found->second << endl; 


To find a value in a map you can use the find method on the map itself, not the stand-alone find 
algorithm. The find method takes the key you wish to search for as a parameter and if that key does 
not exist, the end element of the map is returned. 


Binary Search Trees 


At this point we have covered five different STL containers. In the previous chapter | explained the 
difference between the way a list and a vector are implemented. set and map are also implemented 
differently to the linear containers. The map and set containers are implemented as binary search trees. 


A node in a binary search tree stores pointers to two nodes, one to the left and one to the right. 
Figure 16-1 shows a visual representation of a tree. 
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Figure 16-1. A binary search tree 


The binary search tree stores the tree in a sorted order to make it a very efficient structure when 
looking up nodes. The head node of the tree in Figure 16-1 stores the value 4. If we were looking 
for the node that stores the value 2, we would begin by comparing 2 against the value at the head, 
which is 4. If our search value is equal to the current node, we have found our value. If it is lower we 
move to the left node; if it is higher we move to the right node. As 2 is less than 4, in our example 
we would move to the left node. We would then repeat this process at the new node. We compare 
first to the value of the node, and 2 equals 2, so we know that we have found the node we were 
searching for. 


The process of repeating the same operation over and over like this is known as recursion. We 
generally implement recursive algorithms using functions that call themselves. Listing 16-7 shows an 
implementation of a simple TreeNode class that can be used to recursively search a binary tree structure. 


Listing 16-7. A simple TreeNode 


class TreeNode 


{ 
private: 
int m_value; 


TreeNode* m pLeft = nullptr; 
TreeNode* m_pRight = nullptr; 
public: 

TreeNode(int value) 

: m value{value} 


{} 


TreeNode* Find(int searchValue) 


{ 
TreeNode* pResult = nullptr; 


if (m_value == searchValue) 


{ 
pResult = this; 


else if (m pLeft != nullptr && m value > searchValue) 
pResult = m_pLeft->Find(searchValue) ; 


else if (m_pRight != nullptr && m value < searchValue) 
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pResult = m_pRight->Find(searchValue) ; 
} 


return pResult; 
} 
}; 


All of the code you need to search for a value inside a binary search tree is contained within the Find 
method in Listing 16-7. If you imagine that we have used this class to represent the tree in Figure 16-1, 
then you would have a pointer to the tree head node stored in our program. You can then call Find on 
this node and pass it a value to search for. 


If we pass in 1, the first if statement in Find would fail. The second if statement would pass so we 
would return the result of m_pLeft->Find. This call to find would follow the same process: The first 
if would fail and we would return the result of m_pLeft->Find. This call to find will see the first if 
statement pass, so we do not call another function; we simply return this. At this point, all of our 
function calls will unwind. Our last call to Find returns this to the second call to Find, which returns 
the pointer to the first call to Find, which finally returns it back to the variable being assigned. 


Searching for values in a binary tree is, generally, a faster operation than searching through an array, 
vector, or list. In those collections you would have to potentially compare against every element 

if the value you were looking for was at the very end of the collection. A binary search tree is much 
more efficient. In Figure 16-1 we would only ever have to make 3 comparisons to search against 7 
different values. If we were to add another level to the tree, we would have 4 comparisons to make 
against 15 different values, and another layer would be 5 comparisons for 31 values. You can see 
how quickly these numbers are rising for each level in a binary search tree. 


Note Recursion can be a complicated topic for beginning programmers to understand as it ties in with the 
concept of the program stack. We’ll cover more about this stack in Chapter 22. 


The other major algorithm for traversing a collection is called iteration. You have already seen 
multiple examples of iteration in action and the iterator types you have seen in use take their name 
from this algorithm. Iterating a binary search tree involves visiting each node in turn, and you can use 
iterators on a set and a map to visit each element in order. 


Binary search trees are one way to store data in associative containers, and another is to use a 
hash map. 


Fast Data Access Using a Hash Map 


A binary search tree structure provides fast access to sorted data. The tree is automatically sorted 
when adding data and you’ve seen how a search of that data can be done very quickly. It is possible 
to use an even faster structure than a binary search tree when you do not need to iterate over sorted 
data. A hash map has a constant time insert and retrieval of a value. This means that it will take the 
same length of time to insert the first element as it will to insert the tenth or the millionth. It also has a 
constant time retrieval of data. This means that finding data in a container does not increase the time 
elapsed along with the number of elements the container holds. 
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Hash maps achieve this by turning the key into a hash value and then using that hash to store the 
data in an appropriate bucket. The process of writing a hash map is a complicated task, but luckily 
for us the STL provides us with two ready-made hash map containers, the unordered_set and the 
unordered _map. 


STL unordered_set and unordered_map 


The code for unordered_set and unordered_map is going to look very familiar. Listing 16-8 shows 
how you can specialize these templates. 


Listing 16-8. Specializing unordered_set and unordered_map 


using namespace std; 

using MyUnorderedSet = unordered_set<int>; 

using MyUnorderedMap = unordered_map<int, string>; 
using MyPair = pair<int, string>; 


The unordered_set and unordered_map container templates take the same parameters as the set 
and map containers. The unordered_set stores a value and calculates the key automatically for the 
value,whereas the unordered_map requires that you specify the type to use for the key followed by 
the type for the value. 


You can then initialize and add elements to these containers in the same way you did before, 
as Listing 16-9 shows. 


Listing 16-9. Initializing and Adding to unordered_set and unordered_map 


MyUnorderedSet myUnorderedSet = { 2, 1, 0 }; 
myUnorderedSet.emplace(4) ; 
myUnorderedSet. insert (3); 


MyUnorderedMap myUnorderedMap = { { 2, "Two" }, { 1, "One" }, { 0, "Zero" } }; 
myUnorderedMap.emplace(3, "Three"); 

MyPair node{ 4, "Four" }; 

myUnorderedMap. insert (node) ; 


The code to find elements in an unordered _set is similar to what you have seen previously, either 
using the find algorithm or the find method. Listing 16-10 shows both versions. 


Listing 16-10. Using find with unordered_set 


MyUnorderedSet::iterator found = find(myUnorderedSet.begin(), myUnorderedSet.end(), 2); 
if (found != myUnorderedSet.end()) 
{ 


cout << "Found : 


} 


found = myUnorderedSet.find(2); 
if (found != myUnorderedSet.end()) 
{ 


cout << "Found : 


} 


<< *found << endl; 


<< *found << endl; 
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Values in an unordered_map are accessed a little differently. You will have to use either the [ ] operator 
or the at method. Both are shown in Listing 16-11. 


Listing 16-11. Using [ ] and at 


string& myString = myUnorderedMap[2]; 
cout << "Found : " << myString << endl; 


myString = myUnorderedMap.at(2); 
cout << "Found : "<< myString << endl; 


These methods differ in a very significant way. The [] operator can be used to insert or retrieve 
values from an unordered_map. If the key 2 had not existed in myUnorderedMap, a new string would 
have been added to the map and its reference returned. If the key did already exist, the current string 
would have been returned. The at method never adds a new element to our unordered_map, instead 
it throws an exception. Listing 16-12 shows how you can update the at call to handle exceptions. 


Listing 16-12. Handling Exceptions 


try 

{ 

string& myString = myUnorderedMap.at(5); 
cout << "Found : " << myString << endl; 


} 

catch (const std::out_of_rangeę& outOfRange) 

{ 

cout << "Out of range error: " << outOfRange.what() << endl; 
} 


Your program would have crashed with an unhandled exception error if you had called this code 
without the try...catch block. Throwing your own exceptions is as easy as using the throw 
keyword, as you can see in Listing 16-13. 


Listing 16-13. Throwing Exceptions 
void ExceptionExample() 

{ 

if (true) 

throw -1; 

} 

} 


Catching an exception from this method is shown in Listing 16-14. 
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Listing 16-14. Catching Exceptions 


try 
{ 


ExceptionExample(); 


catch (int errorValue) 


{ 


cout << "Error: 


} 


<< errorValue << endl; 


Note You'll see the unordered_map put to practical use in Chapter 21, which covers an EventManager 
Class that stores Event objects keyed by a unique ID value. 


Summary 


This chapter has introduced you to STL containers based on binary search trees and the hash maps. 
These containers provide alternatives to the other containers, which are of particular benefit when 
you are dealing with large sets of data. The set and map containers are useful when you need to have 
data that is regularly iterated over and you need to be in order, but you also need to find individual 
elements regularly. The unordered_set and unordered_mapcontainers are useful when you need to 
know that inserting and retrieving values will always take the same length of time to execute and you 
do not need the data to be sorted. 


The next chapter introduces you to the stack and queue containers. These containers are more 
specialized versions of existing data structures. Stacks can be used to add and remove elements 
from the top of the container, whereas queues act in a first in, first out manner. 


Chapter 


STL’s Stack and Queue 


The STL containers you have seen so far have all provided options for storing and retrieving values 
and are suited to different circumstances. The stack and queue containers are designed for different 
reasons. Although they do store values, their behavior is much more important. lIl show you exactly 
how these containers behave in this chapter. 


Note The game examples in this book don’t use these containers, but | didn’t want to leave them out. You 
might find a stack useful in a game where you are building a UI system and want to track the path to the 
current screen. I’ve also found a queue to be useful in event systems where you wish to process events in 
the exact order in which they were received. 


The STL stack Container 


The stack container is used when you would like a container that can only be accessed in a last in, 
first out behavior. You can think of this like a tower of blocks. When you place a block onto a tower, 
that is the only block you can then remove. Hopefully you can see how this container is useful more 
for its behavior than for its ability to contain values. Listing 17-1 shows how you can specialize the 
stack container. 


Listing 17-1. Specializing the stack Container 


using namespace std; 
using MyStack = stack<int>; 


You should be growing comfortable with the syntax used when specializing templates. Listing 17-2 
shows how we can create an instance of a stack and add values to it. 
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Listing 17-2. Creating a stack and Adding Values 


MyStack myStack; 
myStack.emplace(0); 
myStack.push(1) ; 
myStack.push(2) ; 


The stack provides a push method to push values onto the top of the stack. Once again you can see 
that this container also has the more optimal emplace method, which provides a faster way to place 
elements onto the top. 


Now that you have values in a stack, you cannot access the data using array operators or iterators, 
as that would break the last in, first out behavior the stack provides. Instead the stack provides the 
top method, which you can see in use in Listing 17-3. 


Listing 17-3. Using stack: : top 


cout << "Top of the stack: " << myStack.top() << endl; 


The code in Listing 17-3 would print the number 2. When you decide that you no longer need the 
value on the top of the stack, you use the pop method to remove the top element from the stack. 
This is shown in Listing 17-4. 


Listing 17-4. Using stack: : pop 
myStack.pop(); 


cout << "Top of the stack: " << myStack.top() << endl; 


The cout call in Listing 17-4 would print the number 2 to your console. You can push and pop values 
to and from a stack as often as you deem necessary. The last remaining important call on a stack 
is the empty method. A call to myStack.empty() would return a boolthat when true means that your 
stack contains no values. 


That’s all there is to know about the stack container. The queue container is very similar but provides 
first in, first out access to its elements. 


The STL queue Container 


Whereas the stack provides last in, first out access, the queue container provides first in, first out 
access. You can visualize this as being like a conveyor belt. The first item you place onto the belt will 
be the first item to reach the end of the belt and each subsequent added item will arrive in that order. 
Listing 17-5 shows all of the code you need to use a queue container. 
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Listing 17-5. The queue Container 


using namespace std; 
using MyQueue = queue<int>; 


MyQueue myQueue; 

myQueue.emplace(0); 
myQueue.emplace(1) ; 
myQueue.emplace(2) ; 


cout << "Front of the queue: " << myQueue.front() << endl; 


myQueue . pop() ; 


The call to front in Listing 17-5 would print 0 to the console. After the call to pop, a call to front 
would result in 1 being returned. The queue class also provides a back method to retrieve the last 
element in a queue, but you cannot remove this element. | haven’t shown this method in action, 

as | have never found much use for it. The queue container is used for its first in, first out properties. 


Summary 


This chapter was short and sweet. The stack and queue containers are much more limited than other 
containers. Although their purpose is to store elements in a manner similar to the other containers 
provided by the STL, they are actually designed to provide restrictions on how you can access their 
elements. 


The stack provides a last in, first out access pattern, whereas the queue provides a first in, first out 
pattern. 


The next chapter covers the last type of STL container you will see in this book, the bitset. 


Chapter 


STL’s bitset 


The last STL container type object that | cover is the bitset. | say STL type because the bitset is 
not strictly a container. It does not support iterators, the range-based for loops, or STL’s algorithms. 
A bitset is used for tracking individual boolean values in a combined set. A traditional method for 
achieving the same result are flags implemented using bitwise operators and shifts. 


Creating bitset Objects 


A bitset is yet another template provided by the STL. A major difference between a bitset and 
other STL containers is that you are not required to specify a type for the bitset. You can see in 
Listing 18-1 that the only parameter taken by the template is the number of bit flags we would like 
the bitset to contain. 


Listing 18-1. Specializing bitset 


#include <bitset> 
using namespace std; 


namespace 


{ 
} 


using MyBitset = bitset<NUMBER_OF BITS>; 


const unsigned int NUMBER_OF BITS = 5; 


This code allows us to create bitsets that consist of 5 bits. We could create a bitset containing 
more or fewer bits by altering the value passed into the template. 
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a 


Listing 18-2 shows the different constructors you can use to initialize bitsets. 


Listing 18-2. bitset Constructors 


MyBitset defaultConstructor; 
MyBitset unsignedLongConstructor{ 0x17 }; 
MyBitset stringConstructor{ string{ "11011" } }; 


There are three constructors you can use. The first is the default constructor, which initializes all bits 
to zero. The second constructor uses an unsigned long to initialize the bits. In this example, | have 
used a literal value to pass into the constructor. The last constructor takes a string containing 1s and 
Os representing the value you wish each bit to contain. 


Working with bitsets 


A bitset provides methods to carry out several different operations. These can be split into methods 
that query the current state of the bitset and methods that are used to alter the bits. Listing 18-3 
shows the methods you can use to gather information about your bitset. 


Listing 18-3. Querying bitsets 


cout << boolalpha; 


cout << "Size of the bitset: " << stringConstructor.size() << endl; 
cout << "Number of set bits: " << stringConstructor.count() << endl; 


cout << "Is any bit set? " << stringConstructor.any() << endl; 
cout << "Are all bits set? " << stringConstructor.all () << endl; 
cout << "Are no bits set? " << stringConstructor.none() << endl; 


for (unsigned int i = 0; i < stringConstructor.size(); ++i) 


cout << "Bit " << i << 
cout << "Bit " << i << " test: 


value: " << stringConstructor[i] << endl; 
" << stringConstructor.test(i) << endl; 


} 


The bitset template provides methods to query the size and count of a bitset. The size method 
should return the size you passed into the template and count will return the number of bits that you 
have set to true. Figure 18-1 shows the output you can expect to see when you execute the code 
from Listing 18-3. 
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Size of the bitset: 5 


all bits set? false 
no bits set? false 
O value: true 

test: true 

value: true 

test: true 

value: false 


value: true 
test: true 
value: true 


8 
1 
1 
2 
2 test: false 
3 
3 
4 
4 test: true 


Figure 18-1. The output generated by executing the code in Listing 18-3 


There are also helper methods that can tell you if any, all, or none of the bits are set. Finally you can 
see two methods to query the status of individual bits. You can either use the array operator and 
index or you can use the test method. 


There are three methods supplied that allow you to alter the values stored in the bitset. These are 
shown in Listing 18-4. 


Listing 18-4. Altering Bits 


stringConstructor.set(1, false); 
stringConstructor.set(1); 
stringConstructor.set(); 


stringConstructor.reset(0); 
stringConstructor.reset(); 


stringConstructor.flip(4); 
stringConstructor.flip(); 


The three methods are set, reset, and flip. Figure 18-2 shows the results of these lines of code in 
the order in which they appear in Listing 18-4. 
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Figure 18-2. The results from the code in Listing 18-4 


The set method has been overloaded to provide different functionality. The first example takes a bit 
index and a value to set the bit to. The second takes just an index, and this method will then set the 
given bit to 1. The final version of set will make all of the bits in the set 1. 


The reset method has similar behavior. It can be passed an index that will reset the given bit to 0 or 
it can be used without parameters, which sets all bits to 0. The flip method also has two versions: 

When given an index it will change the given bit from true to false or false to true and when given 
no parameters it flips the values of all bits. 


Summary 


The bitset template is a simple object provided by the STL to give programs an easy and reusable 
bit flag implementation. Bitsets can be used in game development in a number of situations. | have 
seen them used particularly often in multiplayer development, where transmitting the state of an 
object over the Internet requires that programmers pack data into as small a location as possible. 
Packing boolean values into individual bits is as small as you can possibly get. 


This was our last chapter looking at the containers provided by the STL. The next chapter covers 

a full implementation of the Text Adventure game. The examples of the game you have seen 

so far have been compromised by the fact that we had not yet covered STL containers. Game 
programming involves a lot of data object management and storing objects in appropriate data 
structures is essential. Now that you have seen the different containers the STL provides, you'll be in 
a better position to see how we can write a game in a more structured manner. 
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Chapter 


Using the STL in Text Adventure 


So far you have seen how a game can be built using classes, member variables, and C-style arrays. 
In this chapter you will see how you can use some of the STL classes covered in this part of the 
book to simplify the code you have been creating. This chapter uses polymorphism to store pointers 
to base classes in our STL containers. If you need a recap on polymorphism and how it is used, you 
should read over Chapter 11. 


Some gameplay elements are also added to this chapter. Our Text Adventure game now has an 

end state. There are two enemies in the game world and the player must find and kill both of these 
enemies. Before the player will be able to attack the enemies, they must be armed with a weapon. 
This gameplay logic is relatively simple and there are still only a handful of rooms in the world. This is 
to help keep the code size small so you can get a good grasp on how to write a complete game. 


Using STL array to Store Room Pointers 


When you last saw the code for the Text Adventure game it was using a standard C-style array in 
the Game class to store the Room objects. In this chapter we switch over to using an STL array. 
Listing 19-1 shows the STL array code. 


Listing 19-1. Using an STL array to Store Rooms 


class Game 

{ 

private: 
static const unsigned int m_numberOfRooms = 4; 
using Rooms = std::array<Room, m_numberOfRooms>; 
Rooms m_rooms; 


J 
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Here you can see aconst unsigned int that stores the number of rooms our game contains. The 
game will have the same T layout for the game rooms that we used in Chapter 12. The second line 
uses a type alias to reduce the amount of typing we would need to reference the type of the array in 
other places in the code. We then use the alias to create the array of rooms. 


The rest of the code to deal with the Rooms array remains the same. This is one of the main reasons 
you should switch from old C-style arrays to newer style arrays. The newer style arrays can be used 
with other STL algorithms and also provide iterator support, which C-style arrays do not. 


The Rooms array change is relatively straightforward, but the changes to the Options are much more 
substantial. 


Using a vector and a map to Store Options 


In Chapter 11 the Option pointers were stored in a C-style array in the Game class. This chapter 
reworks the Option storage entirely. The first significant change is that the Option pointers are no 
longer stored in the Game class. Each Room object stores pointers to the relevant options instead. This 
allows us to do some things a little differently. One drawback of the previous solution was that all of 
the options were presented for every room. In this chapter, we only show options that have a logical 
action. This means the player will never see an option to move east if the current Room does not 
have a Room joining to the east. This is a general improvement in usability. 


The options for moving between rooms and for quitting the game are constant operations that 
never change. Our new gameplay logic also includes operations that can only be performed once. 
These are the options to open a chest and the option to attack an enemy. For simplicity’s sake, the 
enemies in our game are currently killed in a single attack and a chest can only be opened once. 
When players carry out these actions, they will not be shown them a second time. This gives us two 
different classes of options, dynamic options and static options. 


We will be storing the dynamic options in a vector. This would allow us to have as many dynamic 
options as necessary and allow us to add new options as the game progresses. Our static options 
will be stored in a map. The map allows the Option pointers to be associated with a key. The key will 
be used to access the Option pointer quickly regardless of how many static options we add. 


While we’re looking at the Room class you can also see that the JoiningRooms array has been updated 
to an STL array, as shown in Listing 19-2. 


Listing 19-2. Using STL Containers in the Room Class 


class Room 
: public Entity 
{ 


public: 
enum class JoiningDirections 
{ 
North = 0, 
East, 
South, 
West, 
Max 


E 
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private: 
using JoiningRooms = std::array<Room*, static_cast<size_t>(JoiningDirections: :Max)>; 
JoiningRooms m_pJoiningRooms ; 


using StaticOptions = std::map<unsigned int, Option*>; 
StaticOptions m_staticOptions; 
unsigned int m_staticOptionStartKey{ 1 }; 


using DynamicOptions = std::vector<Option*>; 
DynamicOptions m_dynamicOptions; 


J} 


A type alias is created for all three of the STL containers in use. The JoiningRooms alias uses a 
static_cast to convert the JoiningDirections::Max enum element into a usable size for the STL 
array. The compiler would give you a specialization error because it cannot implicitly cast an enum 
class value, and the static_cast avoids this error. There are additional type aliases, one for the map 
to store static options and one for the vector that stores the dynamic options. 


The map is keyed by unsigned integers that will allow us to use the numbers entered by the user to 
access the relevant pointer for the selected option. They keys are set automatically by the Room class 
as the Options are added so we set the initial key to 1. 


Note Initializing m_staticOptionStartKey in this manner is using a new C++11 feature. Before C++11 
only static constants that were declared using built-in types could be initialized inside a class. C++11 added 
the ability to initialize members where they are declared to reduce the size of constructors. 


Listing 19-3 shows the new methods that have been added to the Room class to add dynamic and 
static options. 


Listing 19-3. Adding Dynamic and Static Options to Room 


void Room: :AddStaticOption(Option* option) 
{ 
assert(option != nullptr); 
m_staticOptions[m_ staticOptionStartKey++] = option; 


} 


void Room: :AddDynamicOption(Option* option) 
{ 
assert(option != nullptr); 
m_dynamicOptions.push_back(option) ; 


188 CHAPTER 19: Using the STL in Text Adventure 


The static options are added to the map using the [] operator. The key being used is postincremented 
on each insert call. The AddDynamicOption method uses the vector: : push_back method to push the 
new option into the vector. Both methods have a call to assert in their first line that will trigger if the 
Option pointer being added is a nullptr. This will allow you to track down invalid options while your 
program is running. 


Now that the options are stored within a Room instance, the class is required to have a method to 
print the available options to the player, which is shown in Listing 19-4. 


Listing 19-4. Printing the Available Options 
void Room: :PrintOptions() const 
for (unsigned int i = 0; i < m_dynamicOptions.size(); ++i) 
const Option* option = m_dynamicOptions[i]; 


std::cout << i +1 << ": " << option->GetOutputText() << std::endl << std::endl; 


} 


for (StaticOptions::const_iterator iter = m_staticOptions.cbegin(); 
iter != m_staticOptions.cend(); 


++iter) 
{ 
const Option* option = iter->second; 
const unsigned int chosenOption = iter->first + m_dynamicOptions.size(); 
std::cout << chosenOption << ": " 
<< option->GetOutputText() << std::endl << std::endl; 
} 


} 


The PrintOptions method must print out all of the dynamic options followed by the static options. 
Each option is preceded by an index number that the player will then be asked to enter. A for loop 
is used to track the option number to be printed for the dynamic options, and you can see this in the 
cout statement where we add 1 to i when printing. 


Constant iterators are used to loop over the static options. Each static option is keyed starting from 
1 so we can add the size of m_dynamicOptions to each key to find the appropriate index for each 
static option. The iterators represent key—data pairs with the key stored in the first member of the 
pair and the Option pointer stored in second. 


The Room class will also be responsible for evaluating the player’s input. Listing 19-4 shows the 
Room: :EvaluateInput method. 


Listing 19-5. Room: :EvaluateInput 


Option* Room: :EvaluateInput(unsigned int playerInput) 

{ 
Option* option = nullptr; 
const unsigned int numDynamicOptions = m_dynamicOptions.size(); 
if (playerInput <= numDynamicOptions) 
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{ 
unsigned int dynamicIndex = playerInput - 1; 
option = m_dynamicOptions[dynamicIndex] ; 
m_dynamicOptions.erase(m_dynamicOptions.begin() + dynamicIndex) ; 
} 
else 
{ 
option = m_staticOptions.at(playerInput - numDynamicOptions) ; 
} 


return option; 


} 


The player has been presented options that could include dynamic and static options. The static options 
have been offset by the number of dynamic options, so EvaluateInput must account for this offsetting. 
It does this by determining if the entered number is less than the number of dynamic options. If it is then 
the chosen options can be used as an index into the m_dynamicOptions vector after subtracting 1. 


Note We must subtract 1 because the vector indexes begin at 0; however, we have shown the player 
choices beginning at 1, because not many nonprogrammers like to begin counting from 0. 


If the player’s input was greater than the number of dynamic options, we can calculate the key for 
the map of static options by subtracting the number of dynamic options from the player’s input. This 
will work when there are no dynamic options, as the subtraction will remove 0 from the player input 
and we do not need to subtract 1 from the key as we initialized the map’s keys beginning at 1. 


The most important part of this method to pay attention to is the line that calls erase on 
m_dynamicOptions. This is the line that makes these options dynamic, as it ensures that each 
dynamic option can only be called once and it means that the options presented to the player after 
the option has been executed will be different. This is less than ideal from a usability perspective, 
as the user will be presented different numbers to choose the same actions; however, | felt it was a 
useful exercise in showing how a vector can be used for dynamic data sets. 


Adding Gameplay to Text Adventure 


Now that we have a mechanism in place to add dynamic and static options to Room instances, it’s time 
to look at a couple of gameplay elements. The first gameplay element will be the ability to open chests 
and retrieve their contents. To do this we will need a Chest class. Listing 19-6 shows the class definition. 


Listing 19-6. The Chest Class 
class Chest 

: public Entity 
{ 


private: 
const Item* m item; 
bool m_isOpen{ false }; 
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public: 
Chest(const Item* item); 
void Update(); 
bool IsOpen() const 
{ 


return m_isOpen; 


} 

const Item* Open() 

{ 
m_isOpen = true; 
return m_item; 

} 


} 


The Chest class inherits from Entity. This makes sense, as a Chest will be an object that exists in 
the game world in its own right. Chest has two member variables, one to store a pointer to an Item 
and a bool to track if the Chest is open. 


The Open method sets m_isOpen to true and returns the pointer to the stored Item to the caller. 
The Item class is shown in Listing 19-7. 


Listing 19-7. The Item Class 


class Item 


{ 
private: 
std::string m_name; 


public: 
Item(const std::string& name) 
: m_name{ name } 
{ 
} 
virtual ~Item() {} 


const std::string& GetName() const 


{ 
} 


return m_name; 
}; 


The only useful functionality provided by the Item class is to store a string that contains the Item’s 
name. This allows us to print the name of the Item to the player when they pick it up. This means 
that we need an Item that the player can collect. Listing 19-8 shows the Sword class. 
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Listing 19-8. The Sword Class 


class Sword 
: public Item 


{ 
public: 
Sword() 
: Item("Sword") 
{ 
} 
}; 


The Sword class does not do anything particularly exciting; its only method is a constructor that is 
used to pass the string "Sword" through to the Item parent class constructor. 


The interesting work is done by our new OpenChestOptions class, which derives from Option, shown 
in Listing 19-9. 
Listing 19-9. The OpenChestOption Class 
class OpenChestOption 
: public Option 
{ 


private: 
Chest* m_chest; 


public: 
OpenChestOption(Chest* chest, const std::string& outputText) 
: m_chest{chest} 
» Option(PlayerOptions::OpenChest, outputText) 
{ 


} 


virtual void Evaluate(Player& player); 
}; 


The OpenChestOption class stores a pointer to the Chest object on which it will operate. It also overrides 
the Evaluate method from the Option parent class. The Evaluate method is shown in Listing 19-10. 


Listing 19-10. OpenChestOption: : Evaluate 
void OpenChestOption: :Evaluate(Player& player) 


{ 
if (m_chest->IsOpen() == false) 
{ 
const Item* item = m_chest->Open(); 
player .AddItem(item) ; 
std::cout << "You picked up a " << item->GetName() << " from the chest!" 
<< std::endl << std::endl; 
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The Evaluate method is where the Chest: :Open call is made. The method first checks to see if the 
Chest is closed; if it is, then the Open call is made and the Item pointer is passed to Player: : AddItem. 
The last task is to print a message informing the player which Item was obtained from the Chest. 


The Evaluate method brings us nicely to our next example of STL containers in our game. The Player 
class requires storage for the Item objects that the user can obtain. You can see in Listing 19-11 
that a vector<Item*> has been added to the Player class. 


Listing 19-11. The Player Class’s Item vector 


class Player 
: public Entity 


{ 
private: 
using Items = std::vector<Item*>; 
Items m_items; 
void AddItem(const Item* item) 
{ 
m_items.push_back(const_cast<Item*>(item)); 
} 
bool HasWeapon() 
{ 
bool hasWeapon = false; 
for (const Item* item : m items) 
{ 
const Sword* sword = dynamic_cast<const Sword*>(item) ; 
if (sword != nullptr) 
{ 
hasWeapon = true; 
break; 
} 
} 
return hasWeapon; 
} 
}; 


Listing 19-11 only shows the new code that has been added to Player. We now have an alias for the 
Item* vector, the vector instance and two new methods, AddItem and HasWeapon. 


AddItem is simply used to push new items onto the m_items vector. The HasWeapon method is a little 
more interesting. It uses a dynamic_cast to determine if the current Item pointer is actually a Sword 
class. A dynamic_cast will return nullptr if the type conversion is invalid; therefore, only objects that 
are actually Swords will successfully return a valid Sword pointer. Once we have a valid Sword pointer 
we know that the player has a weapon, so hasWeapon can be set to true and we can break out of our 
loop. The loop in question is a range-based for loop that takes advantage of our STL class. 


The Player class has a method to determine whether the player is armed or not because we are 
going to add enemies to some of the Room objects. Listing 19-12 shows the Enemy class. 
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Listing 19-12. The Enemy Class 


class Enemy 
: public Entity 
{ 


public: 
enum class EnemyType 


{ 
Dragon, 
Orc 


J} 


private: 
EnemyType m_type; 
bool m alive{ true }; 


public: 
Enemy(EnemyType type) 
: m_type{ type } 
{ 


} 


bool IsAlive() const 
{ 


} 
void Kill() 
{ 


return m alive; 


m_alive = false; 
}; 


Text Adventure will support two different kinds of enemies for now, Dragons and Orcs. These types 
have been represented in the EnemyType enum. The only other member variable is a bool that 
determines if the Enemy is dead or alive; this goes along with the two helper methods, IsAlive and 
Kill, which query and set the state of the m_alive variable. 


As you might have guessed, there is a new class derived from Option that allows the user to kill the 
enemies. Listing 19-13 shows the AttackEnemyOption class. 


Listing 19-13. The AttackEnemyOption Class 


class AttackEnemyOption 
: public Option 
{ 


private: 
Enemy* m_enemy; 


public: 
AttackEnemyOption(Enemy* enemy, const std::string& outputText) ; 


virtual void Evaluate(Player& player); 
}; 
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Listing 19-14 shows the code for the Evaluate method. 


Listing 19-14. AttackEnemyOption: : Evaluate 


void AttackEnemyOption: :Evaluate(Player& player) 


{ 
std::cout << std::endl << "You have chosen to " << m_outputText 
<< std::endl << std::endl; 
if (player.HasWeapon()) 
{ 
if (m_enemy->IsAlive()) 
{ 
m_enemy->Kill(); 
std::cout << "You killed it!" << std::endl << std::endl; 
} 
} 
else 
{ 
std::cout << "You need to find a weapon before attacking monsters!" 
<< std::endl << std::endl; 
} 
} 


The Player: :HasWeapon method is put to good use here to make sure that the user can only attack 
enemies when they are armed. The final changes required to tie everything together are in the Game 
class, which is shown in Listing 19-15. 


Listing 19-15. The Updated Game Class 


class Game 

{ 

private: 
static const unsigned int m_numberOfRooms = 4; 
using Rooms = std::array<Room, m_numberOfRooms>; 
Rooms m_rooms; 


Player m_player; 


AttackEnemyOption m_attackDragonOption; 
AttackEnemyOption m_attackOrcOption; 
MoveOption m_moveNorthOption; 
MoveOption m_moveEastOption; 

MoveOption m_moveSouthOption; 
MoveOption m_moveWestOption; 
OpenChestOption m_openSwordChest; 
QuitOption m_quitOption; 


Sword m_sword; 
Chest m_swordChest; 


Enemy m_dragon; 
Enemy m_orc; 
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İİ 


void InitializeRooms(); 

void WelcomePlayer(); 

void GivePlayerOptions() const; 

void GetPlayerInput(std::stringstream& playerInput) const; 

PlayerOptions EvaluateInput(std::stringstream& playerInput) ; 
public: 

Game () ; 


void RunGame() ; 


E 


The Game class now has two AttackEnemyOption instances, an OpenChestOption, a Sword, Chest, and 
two Enemy class instances. These are initialized in the constructor, shown in Listing 19-16. 


Listing 19-16. The Game Constructor 


Game: :Game() 

: m_attackDragonOption(&m_dragon, "Attack Dragon") 
m_attackOrcOption(&m orc, "Attack Orc") 
m_moveNorthOption(Room: : JoiningDirections::North, PlayerOptions::GoNorth, "Go North") 
m_moveEastOption(Room: : JoiningDirections::East, PlayerOptions::GoEast, "Go East") 
m_moveSouthOption(Room: : JoiningDirections::South, PlayerOptions::GoSouth, "Go South") 
m_moveWestOption(Room: : JoiningDirections::West, PlayerOptions::GoWest, "Go West") 
m_openSwordChest(&m swordChest, "Open Chest") 
m_quitOption("Quit") 
m_swordChest(&m_sword) 
m_dragon(Enemy: : EnemyType: :Dragon) 
m_orc(Enemy: : EnemyType: :Orc) 
{ 


} 


Listing 19-17 shows how these are added to the Room instances using the new AddStaticOption and 
AddDynamicOption methods. This is done in the Game: : InitializeRooms method. 


Listing 19-17. Game: : InitializeRooms 


void Game: : InitializeRooms() 

{ 
// Room O heads North to Room 1 
m_rooms[0].AddRoom(Room: : JoiningDirections::North, &(m_rooms[1])); 
m_rooms[0].AddStaticOption(&m_moveNorthOption) ; 
m_ rooms[0].AddStaticOption(&m quitOption) ; 
m_rooms[0].AddDynamicOption(&m_ openSwordChest) ; 


// Room 1 heads East to Room 2, South to Room O and West to Room 3 
m_rooms[1].AddRoom(Room: : JoiningDirections::East, &(m_rooms[2])); 
m_rooms[1].AddStaticOption(&m moveEastOption) ; 
m_rooms[1].AddRoom(Room: : JoiningDirections::South, &(m_rooms[0])); 
m_rooms[1].AddStaticOption(&m_moveSouthOption) ; 
[ 
[ 
[ 


m_rooms[1].AddRoom(Room: : JoiningDirections::West, &(m_rooms[3])); 
m_rooms[1].AddStaticOption(&m moveWestOption) ; 
m_rooms[1].AddStaticOption(&m quitOption) ; 
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// Room 2 heads West to Room 1 
[2].AddRoom(Room: : JoiningDirections::West, &(m_rooms[1])); 

E [2].AddStaticOption(&m_moveWestOption) ; 

m_ rooms[2].AddStaticOption(&m quitOption) ; 

m_rooms[2].AddDynamicOption(&m_attackDragonOption) ; 


// Room 3 heads East to Room 1 
m_rooms[3].AddRoom(Room: : JoiningDirections::East, &(m_rooms[1])); 
m_rooms[3].AddStaticOption(&m moveEastOption) ; 
m_rooms[3].AddStaticOption(&m quitOption) ; 
m_rooms[3].AddDynamicOption(&m attackOrcOption) ; 


m_player.SetCurrentRoom(&(m_rooms[0])); 


} 
The GivePlayerInput method is now much simpler, as you can see in Listing 19-18. 


Listing 19-18. Game : :GivePlayerInput 


void Game: :GivePlayerOptions() const 


{ 
cout << "What would you like to do? (Enter a corresponding number)" << endl << endl; 
// Print the options for the room 
m_player.GetCurrentRoom()->PrintOptions(); 

} 


The EvaluateInput method has some slightly more complicated code, shown in Listing 19-19. 


Listing 19-19. Game: :EvaluateInput 
PlayerOptions Game: :EvaluateInput(stringstream& playerInputStream) 
PlayerOptions chosenOption = PlayerOptions: :None; 


unsigned int playerInputChoice{ 0 }; 
playerInputStream >>playerInputChoice; 


try 
{ 
Option* option = m_player.GetCurrentRoom()->EvaluateInput (playerInputChoice) ; 
option->Evaluate(m_ player) ; 
chosenOption = option->GetChosenOption(); 
} 
catch (const std::out_of range&) 
{ 
cout << "I do not recognize that option, try again!" << endl << endl; 
} 


return chosenOption; 
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The user’s input has been captured into a stringstream that is used to get the unsigned int option 
selected. There is then a try..catch block. This is exception handling in C++. Exceptions can be 
generated by any code you call that does not result in a valid operation. In our case we could be 
passing an invalid option to the Room: :EvaluateInput method. This invalid option would be used to 
try to get a pointer from the static options map and when the key could not be found, the map code 
would throw an out_of_range exception. 


Note If we failed to catch this exception, our program execution would stop, but by handling the exception 
we have been able to show the user an appropriate error message and carry on. 


The last method to get an update is the RunGame method. Listing 19-20 shows the updates to 
this method. 


Listing 19-20. Game: : RunGame 


void Game: :RunGame() 


{ 


InitializeRooms(); 
WelcomePlayer(); 
bool playerWon = false; 
bool playerQuit = false; 
while (playerQuit == false && playerWon == false) 
{ 
GivePlayerOptions(); 


stringstream playerInputStream; 
GetPlayerInput (playerInputStream) ; 


PlayerOptions selectedOption = EvaluateInput(playerInputStream) ; 
playerQuit = selectedOption == PlayerOptions: :Quit; 


playerWon = m_dragon.IsAlive() == false && m_orc.IsAlive() == false; 
} 


if (playerWon == true) 
{ 


cout << "Congratulations, you rid the dungeon of monsters!" << endl; 
cout << "Type goodbye to end" << endl; 

std::string input; 

cin >>input; 


198 CHAPTER 19: Using the STL in Text Adventure 


The main change here is that a win condition has been added to the game loop. The while condition 
now checks to see whether the user has chosen the quit option or if they have won. The playerWon 
bool is set to true once both of the enemies in the game world have been killed, which also means 
the player successfully opened the Chest. 


Summary 


This update to Text Adventure concludes this part of the book. I’ve given you a whirlwind tour of the 
most useful STL containers for game developers and you should now be able to use these in your 
own projects with ease. 


This chapter has shown some practical examples of how you can deploy STL containers in game 
code. You’ve seen that STL array can be used for data that you know will remain constant, such as 
the Rooms in the world or the JoiningDirections in each Room. You’ve also seen how a vector can be 
used for more dynamic data structures. Text Adventure uses vectors to store dynamic options that 
are erased after they are used and also to hold the Player class’s inventory, which would allow the 
inventory to grow until the memory available on the computer is exhausted. You also saw how a map 
can be used to provide convenient access to objects via a key—data pair relationship. 


Hopefully by now you’re also comfortable with the C++ syntax for specializing templates. The next 
part of this book is going to show you how you can create your own template methods and classes 
to do some really neat and powerful things in the C++ programming language. 


Part 


Generic Programming 


Although the STL provides a ready-made library of templates to cover many requirements, there is 
no escaping the fact that you will eventually need to use the ability to create your own templates. 


The C++ template compiler is a complex, underused, and exceptionally useful piece of software. 
As well as letting you abstract types out of your classes to create generic and reusable code, the 
template compiler can also let you calculate constant values at compile time. This type of template 
programming is known as template metaprogramming. 


This part of the book introduces you to the features C++ provides to create your own templates. 
It also shows you how to use some built-in template metaprograms and even ends with an example 
of how you can create your own template metaprogram. 


Chapter 


Template Programming 


Parts 1 and 2 of this book introduced you to concepts and features of the C++ programming 
language that allow the procedural programming paradigm and the object-oriented programming 
paradigm. C++ provides functions and control flow statements that allow you to break your 
programs down into reusable blocks and it provides classes that allow you to encapsulate your data 
and bundle it with methods that act on that data. C++ also supports a third programming paradigm, 
generic programming. 


Generic programming is conceptually more complicated than the procedural and object-oriented 
programming paradigms. You can think of generic programming in C++ as programming with types. 
You’ve seen examples of this in the previous part of this book when you saw how to specialize STL 
containers. The STL containers are generic in that they do not know which type they are until the 
code is compiled. When you specialize a template, you are required to pass the types as arguments. 
This process creates a new type; vector<int> is a completely different type to vector<char>. 


Templates were created to provide this type abstraction in programs. After templates were 
implemented, programmers started to discover that templates could do much, much more than 
just abstract out types. They discovered that the template compiler could evaluate constant values 
and compile new constant values. This has given rise to another element to template programming 
known as template metaprogramming. 


This chapter gives a brief introduction to template compilation by discussing the difference 
between compile time and runtime evaluation, the difference between const and constexpr, and the 
difference between assert and static_assert. 


Compile Versus Runtime Time Compilation 


Compilers are complex pieces of software that are capable of turning your source code into 
instructions that can be consumed by a processor. During the compilation process, they are also 
capable of carrying out other tasks, including preprocessing and optimization. The compiler is 

also responsible for processing templates. Templates are generic and therefore the source code 
itself cannot resolve the types in use in the template code. The compiler could try to instantiate a 
version of the template for every single type and class in your program, but this would likely be very 
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slow and require much more memory than necessary. Instead the compiler creates specializations 
of templates as and when it encounters them in your code. This process of creating specialized 
templates from the generic templates is why the compiler considers vector<int> to be a different 
type to vector<char>. 


Note As you have seen in previous chapters, it can be a great idea to use type aliases to make it clear in 
your code when a template specialization is declaring a new type. 


What the template compiler does then is generate specific source code that is turned into 
instructions by subsequent steps in the compiler. This has led to the ability of the template compiler 
to be considered Turing complete. Being Turing complete means that the template compiler is 
considered capable of carrying out all of the computation capabilities of an early computer created 
by Alan Turing. In effect, the template compiler in C++ is able to do many things outside of just 
making types generic. 


Before we look at how templates can be used in game code in the next chapter, we need to cover 
some of the basics. Listing 20-1 shows how a simple template can be created. 


Listing 20-1. Creating a template Class 


template <typename T> 
class Template 


{ 
private: 
T* m_ptr; 


public: 
Template(T* ptr) 
: m_ptr{ptr} 
{ 


} 
E 


Listing 20-1 shows how we can tell the compiler that we would like our class to contain a member 
variable that is of an unspecified type. This is achieved in the very first line with template <typename T>. 
The <> syntax should be familiar from the STL chapters and is also the form we use to specify the 
name for our generic type, in this case T. 


Note Where Listing 20-1 uses the typename keyword, it’s also possible to use the class keyword. The 
class keyword was initially used to declare template types, but it was superseded by the typename 
keyword to reduce the overloading on the class keyword. Some older code might still use the class 
keyword for compatibility, but typename should be used in any new code. 
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The class can use the T type in place of a standard type. The compiler will replace the T anywhere it 
is used with the type supplied when the template is specialized. Listing 20-2 shows how this class 
template can be specialized. 


Listing 20-2. Specializing a Template 


int value = 1; 
Template<int> pointer (&value) ; 


When we compile our program the compiler will automatically create a class for the Template<int> 
type that replaces T with int. 


The remainder of this chapter looks at the way we can specify constant values to be used by the 
template compiler and look at the difference between a runtime and compile time assert. 


const Versus constexpr 


C++11 introduced the constexpr keyword to coexist with the const keyword. You’ve already seen 
const used in this book. In those instances we used const to create variables that were unable to 
be changed by the program after they were defined. These variables are runtime variables. We can 
have constants defined inside local variables using values passed from parameters. Parameters 
themselves can even be constant and in these cases there is no way for the compiler to know 
whether the values the variables contain are literal constant values or values determined at runtime. 


The constexpr keyword has been added to aid in this distinction. If you create a variable using 
constexpr the compiler will throw a compiler error if it cannot determine the value of the variable at 
compile time. 


Note Unfortunately, at the time of writing, Microsoft has not yet added support in their latest compiler 
included with Visual Studio 2013. 


Listing 20-3 shows two scenarios where const and constexpr will provide different results. 


Listing 20-3. const Versus constexpr 


const double constValue = sin(0.5); 
constexpr double constexprValue = sin(0.5); 


void ConstFunction(double value) 


{ 


const double constValue = value; 
constexpr double constexprValue = value; 
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The first two lines of Listing 20-3 will compile without issue. The compiler can work out the value of 
the result from the sin function at compile time and store the values in the variables. The constexpr 
variable inside the ConstFunction, however will result in a compile error. GCC gives the following 
output message: error: ‘value’ is not a constant expression. This happens because the compiler 
cannot guarantee that the method will not be passed a value that it cannot determine at compile time. 


assert Versus static_assert 


The assert and static_assert methods have the same runtime versus compile time distinction as 
const and constexpr. An assert is used to halt your program’s execution if you pass in false at 
runtime. Listing 20-4 shows a use of assert. 


Listing 20-4. assert 


#include <cassert> 
int main() 


assert(2 == 3); 


} 


The 2 == 3 expression will result in false being passed to the assert. This will cause the code 
execution to stop in your debugger and allow you to continue. A static_assert on the other hand 
causes the compiler to throw an error. Listing 20-5 shows a static_assert. 


Listing 20-5. static_assert 


#include <cassert> 
int main() 


static_assert(2 == 3, "Two does not equal three"); 


} 


When you compile this code using GCC you should see the following error: error: static assertion 
failed: Two does not equal three. This is the purpose of the string being passed to the 
static_assert: It is printed out as part of your compile error. These type of asserts are very useful 
when trying some template metaprogramming. 


Summary 


This chapter has shown you the very basics of how to create templates in your own code, including 
the difference between compile time and runtime evaluation through a look at the difference between 
const and constexpr, and assert and static_assert. You’ve seen a basic use of the template and 
typename keywords and how these are used to create type abstractions in your code. 


The remaining chapter in this part of the book covers how you can use templates in the Text 
Adventure game in the form of template function, template classes, and finally an example of how 
template metaprogramming can be used to calculate an SDBM hash at compile time. 


Chapter 2 1 


Practical Template Programming 


This chapter introduces you to some practical template examples so you can see how they can be 
deployed in your game development projects. You'll see how to implement a Singleton class that 
will allow you to create objects that can be accessed from anywhere in your code base. The Singleton 
pattern also ensures that you can only create a single instance of those classes. 


You'll then see how you can create an event broadcasting system. This system itself will not use 
templates, but we will be creating some friend functions that will be implemented using templates 
to ensure that the objects being passed as parameters are set up to listen for events. The event 
manager class will also use a template function that will calculate hash values to uniquely identify 
the events in our system. Both of these example template functions will be showing you template 
metaprogramming in action. 


This chapter starts with the Singleton pattern. 


Creating Singleton Classes with Templates 


A Singleton class is used to create a single instance of an object in your program. This object 
uses a static member variable and static functions to allow your code to access the object without 
requiring you to pass it through all of your code. There are multiple methods you can use to implement 
singletons. One common approach is to add a static member and functions to classes manually. This 
approach is error prone if you create enough singletons, so it would be better to find a more consistent 
approach. It turns out that we can use a template and inheritance to create a single implementation 
that we can add to any class. Listing 21-1 shows the source code required to create a Singleton. 


Listing 21-1. The Singleton Class 


template <typename T> 
class Singleton 
{ 
private: 
static T* m_instance; 
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public: 
Singleton() 
assert(m instance == nullptr); 
if (m_instance == nullptr) 
{ 
m_instance = static_cast<T*>(this); 
} 
} 
virtual ~Singleton() 
{ 
m_instance = nullptr; 
} 
static T& GetSingleton() 
{ 
return *m_instance; 
} 
static T* GetSingletonPtr() 
{ 
return m_instance; 
} 


}3 


template <typename T> 
T* Singleton<T>::m_instance = nullptr; 


There are three main aspects of this class that you should pay attention to with respect to 
implementing template classes. The very first line of Listing 21-1 shows that you use the template 
keyword to tell the compiler that we are creating a template. Using typename T then tells the 
compiler that the type T will be provided when we specialize this template in our code. The type T is 
then used to create a static pointer to a T object named m_instance. 


The last important piece of template code is the definition of the m_instance variable on the last line. 
The template <typename T> keywords are needed again as the variable definition exists outside 
of the template class block. 


The Singleton constructor contains an assert to alert you if you try to create more than a single 
instance of a particular object. There is also a static cast as the pointer in the constructor will be 
of type Singleton, not type T. It’s safe to use a static cast and not a dynamic cast in this instance 
because we will only ever be casting from a Singleton to the type that derived from Singleton. 
Listing 21-2 shows how we can use the Singleton template when creating another class, the 
EventManager. 


CHAPTER 21: Practical Template Programming 207 
Listing 21-2. The EventManager Class 


#include "Singleton.h" 


class EventManager 
: public Singleton<EventManager> 
{ 


i 


You can see here that the Singleton class is derived from by EventManager, but you also pass the 
type EventManager to the Singleton template. This is a template programming pattern known as 
the curiously recurring template pattern (you can get more information about this topic from 
http://en.wikipedia.org/wiki/Curiously recurring template_pattern). You can now create and 
delete Singleton derived classes in the manner shown in Listing 21-3. 


Listing 21-3. Instantiating the EventManager 


void Game: :RunGame() 


{ 


new EventManager(); 

InitializeRooms(); 

WelcomePlayer(); 

bool playerWon = false; 

bool playerQuit = false; 

while (playerQuit == false && playerWon == false) 


GivePlayerOptions(); 


stringstream playerInputStream; 
GetPlayerInput (playerInputStream) ; 


PlayerOptions selectedOption = EvaluateInput(playerInputStream) ; 
playerQuit = selectedOption == PlayerOptions: :Quit; 


playerWon = m_dragon.IsAlive() == false && m_orc.IsAlive() == false; 
} 


if (playerWon == true) 


cout << "Congratulations, you rid the dungeon of monsters!" << endl; 
cout << "Type goodbye to end" << endl; 

std::string input; 

cin >>input; 


} 


delete EventManager: :GetSingletonPtr(); 
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The bold lines of code in Listing 21-3 contain the first uses of new and delete that you have seen 
in this book. You don’t need to worry about the details of what these keywords do at the moment, 
as we’ll be covering dynamic memory allocation in detail in Chapter 24. You can however place a 
breakpoint in the Singleton constructor and destructor to see those in action. 


We’ll add more code to the EventManager class before it will prove to be useful, so we cover that now. 


Implementing the EventManager Class 


The EventManager is going to store Event objects in an unordered_map. The keys to this map will be 
hash values calculated from strings that will be used to register events, attach listeners to events, 
and eventually send the events. This means that you will need an Event class, an EventHandler 
class, and a method to convert strings into unique hashes. Once these classes are all in place and 
operational we’ll replace the current method used to detect when the player has chosen to quit the 
game with the new event system. 


The EventHandler Interface 


Listing 21-4 shows the code for the EventHandler interface. 


Listing 21-4. The EventHandler Interface 


class Event; 


class EventHandler 


{ 
public: 
virtual void HandleEvent(const Event* pEvent) = 0; 


J 


The EventHandler interface is very basic. It simply provides a base class from which other classes 
can derive to give themselves a common interface that can be used by the rest of the event system. 
The Event class is one place where this is important, as it stores a vector of EventHandler pointers. 


The Event Class 


The Event class will be used to represent an individual event within the EventManager. This event 
class is responsible for forwarding the event to all attached listener objects. To achieve this, the 
Event class will store EventHandler pointers in a vector. You can see this in Listing 21-5. 


Listing 21-5. The Event Class 


using EventID = int; 
class EventHandler; 


class Event 


{ 
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private: 
using EventHandlerList = std::vector<EventHandler*>; 
using EventHandlerListIterator = EventHandlerList::iterator; 


EventHandlerList m_listeners; 
EventID m_id; 


public: 
explicit Event(EventID eventId); 


void Send(); 

void SendToHandler(EventHandler& eventHandler); 
void AttachListener(EventHandler& eventHandler); 
void DetachListener(EventHandler& eventHandler); 


EventID GetID() const { return m_id; } 
}; 


The Event class has a vector of EventHandler pointers. These are pointers to objects that have 
derived from EventHandler and are listening for a specific event. An Event also has an EventID 
variable that allows the event to be identified. 


The explicit keyword before the constructor ensures that instances of the class can only be created 
when passing in an EventID or integer type. The class also has methods that are used to attach and 
detach listeners and for sending the event either to all listeners of a specific EventHandler. Listing 21-6 
shows the code for the AttachListener and DetachListener methods. 


Listing 21-6. The AttachListener and DetachListener Methods 


void Event: :AttachListener(EventHandler& eventHandler) 


{ 
m_ listeners.push_back(&eventHandler) ; 
} 
void Event: :DetachListener(EventHandler& eventHandler) 
{ 
for (EventHandlerListIterator iter = m listeners.begin(); 
iter != m listeners.end(); 
++iter) 
{ 
if (eventHandler == *iter) 
{ 
m _listeners.erase(iter); 
break; 
} 
} 
} 


The AttachListener and DetachListener methods are responsible for adding and removing a given 
EventHandler object from the m_listeners vector. This vector becomes useful when you would like 
to send the Event to all of the pointers it stores, as you can see in Listing 21-7. 


210 CHAPTER 21: Practical Template Programming 
Listing 21-7. The Event: : Send Method 


void Event: :Send() 


{ 
for (auto& listener : m listeners) 
{ 
if (listener != nullptr) 
{ 
listener->HandleEvent (this); 
} 
} 
} 


The Send method is straightforward. It simply loops all over the m_listeners vector and calls the 
HandleEvent method on each valid entry. 


The SendToHandler method is given in Listing 21-8. It sends the message to a single EventHandler 
rather than all of them. 


Listing 21-8. The Event: :SendToHandler Method 


void Event: :SendToHandler(EventHandler& eventHandler) 


{ 
auto found = std::find(m listeners.begin(), m_listeners.end(), &eventHandler) ; 
if (found != m listeners.end()) 
{ 
(*found) ->HandleEvent (this) ; 
} 
} 


This time we use the find STL algorithm to get an iterator to the entry that stores our EventHandler 
and then call HandleEvent if it is found. 


Now that we have an interface for EventHandlers and a class to represent Events, we can look at 
how the EventManager class is implemented. 


The EventManager Implementation 


Listing 21-9 shows the member variables and methods contained in the EventManager class. 


Listing 21-9. The EventManager Members and Methods 


class EventManager 
: public Singleton<EventManager> 
{ 


friend void SendEvent(EventID eventId) ; 


template <typename T> 
friend void SendEventToHandler(EventID eventId, T* eventHandler); 


friend bool RegisterEvent(EventID eventId); 
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private: 


public: 


J; 


template <typename T> 
friend void AttachEvent(EventID eventId, T* eventHandler); 


template <typename T> 
friend void DetachEvent(EventID eventId, T* eventHandler); 


using EventMap = std::unordered_map<EventID, Event*>; 
using EventMapIterator = EventMap::iterator; 


EventMap m_eventMap; 
void SendEvent (EventID eventId); 


void SendEventToHandler(EventID eventId, EventHandler& eventHandler); 
bool RegisterEvent(EventID eventId); 


void AttachEvent(EventID eventId, EventHandler& eventHandler); 


void DetachEvent(EventID eventId, EventHandler& eventHandler); 


virtual ~EventManager(); 


The EventManager class has an interesting design. The Event objects are stored in an unordered_map 
using the EventID as a key. There are also private member methods that contain the behavior of the 
class: SendEvent, SendEventToHandler, RegisterEvent, AttachEvent, and DetachEvent. There are also 
public friend methods that are used to wrap these function calls and use template code. lII show 


you the 


code for the private methods first then talk you through how and why the public friend 


functions are used. Listing 21-10 contains the code for the RegisterEvent method. 


Listing 21-10. EventManager: :RegisterEvent 


bool EventManager: :RegisterEvent(EventID eventId) 


{ 


bool added = false; 


EventMapIterator result = m_eventMap.find(eventId) ; 
if (result == m_eventMap.end()) 


{ 
Event* pNewEvent = new Event(eventId) ; 
if (pNewEvent) 
std::pair<EventID, Event*> newEvent(eventId, pNewEvent) ; 
auto addedIter = m eventMap.insert(newEvent) ; 
added = addedIter.second; 
} 
} 
assert(added); 


return added; 
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The RegisterEvent method first searched the m_eventMap variable using find to see if an Event with 
the same eventID already exists. If it does not, then a new Event object is created and added to the 
unordered_map. The AttachEvent and DetachEvent methods find the Event object for the specified 
eventID and add or detach the supplied EventHandler object, using the code shown in Listing 21-11. 


Listing 21-11. The EventManager AttachEvent and DetachEvent Methods 


void EventManager: :AttachEvent(EventID eventId, EventHandler& eventHandler) 


{ 
EventMapIterator result = m_eventMap.find(eventId) ; 
assert(result != m_eventMap.end()); 
if (result != m_eventMap.end()) 
{ 
assert (result->second) ; 
result->second->AttachListener(eventHandler) ; 
} 
} 
void EventManager: :DetachEvent(EventID eventId, EventHandler& eventHandler) 
{ 
EventMapIterator result = m_eventMap.find(eventId) ; 
assert(result != m_eventMap.end()); 
if (result != m_eventMap.end()) 
{ 
assert (result->second) ; 
result->second->DetachListener(eventHandler) ; 
} 
} 


These methods are quite simple: They find the Event object for the given eventID and call the Event 
class’s AttachListener or DetachListener, respectively. The SendEvent and SendEventToHandler 
methods are equally simple and shown in Listing 21-12. 


Listing 21-12. The EventManager SendEvent and SendEventToHandler Methods 


void EventManager: :SendEvent(EventID eventId) 
{ 


EventMapIterator result = m_eventMap.find(eventId) ; 
if (result != m_eventMap.end()) 


{ 
assert (result->second) ; 
if (result->second) 
{ 
result->second->Send(); 
} 
} 
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void EventManager: :SendEventToHandler(EventID eventId, EventHandler& eventHandler) 


{ 


EventMapIterator result = m_eventMap.find(eventId) ; 
if (result != m_eventMap.end()) 


{ 
assert (result->second) ; 
if (result->second) 
{ 
result->second->SendToHandler(eventHandler) ; 
} 
} 


} 


The destructor for the EventManager class is also interesting. It is responsible for cleaning up 
the Event objects in the unordered _map. As they were created using the new keyword, they must 
be destroyed using the delete keyword (I cover this in detail in Chapter 24). The EventManager 
destructor is given in Listing 21-13. 


Listing 21-13. The EventManager Destructor 


EventManager: : ~EventManager () 


{ 
for (EventMapIterator iter = m_eventMap.begin(); iter != m_eventMap.end(); ++iter) 
i 
Event* pEvent = iter->second; 
if (pEvent) 
delete pEvent; 
iter->second = nullptr; 
} 
m_eventMap.clear(); 
} 


The destructor iterates over the m_eventMap variable, deletes each Event, and sets the second 
member on the iterator to be nullptr. 


Now I can show you the public friend functions that wrap the EventManager private methods. 
Listing 21-14 shows the code for the SendEvent friend function. 


Listing 21-14. The SendEvent friend Function 


inline void SendEvent(EventID eventId) 


{ 


EventManager* pEventManager = EventManager: :GetSingletonPtr(); 
assert (pEventManager) ; 
if (pEventManager) 


pEventManager->SendEvent (eventId) ; 
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The point of using this friend function is to reduce the amount of code we must write each time we 
would like to send an Event. If we did not have this friend function, we would need to write the six 
lines it contains each time. Instead of this we can simply write 


SendEvent (someEvent) ; 


The friend function also safely checks that the Singleton EventManager class has been 
created. This is useful, as there might be situations in which you might like to test without the 
EventManager. The SendEvent function itself is relatively simple and calls the SendEvent private 
member on the EventManager class. This is a benefit of the friend function: It can access 

the private members and methods of any class it is a friend of. Using this technique you can 
ensure that only the public friend functions can be used to interact with the EventManager. 
Listing 21-15 shows the RegisterEvent function, which is equally straightforward. 


Listing 21-15. The RegisterEvent Function 


inline bool RegisterEvent(EventID eventId) 


{ 
bool added = false; 


EventManager* pEventManager = EventManager: :GetSingletonPtr(); 
assert (pEventManager) ; 
if (pEventManager) 


added = pEventManager->RegisterEvent(eventId) ; 
} 


return added; 


} 


The other three functions interact with the EventManager in a similar way; however, they do have a 
significant difference. They contain a little template metaprogramming. Listing 21-16 shows all three 
remaining functions. 


Listing 21-16. The SendEventToHandler, AttachEvent, and DetachEvent friend Functions 


template <typename T> 
inline void SendEventToHandler(EventID eventId, T* eventHandler) 
{ 
static_assert(std::is_base_of<EventHandler, T>::value, 
"Class provided is not derived from EventHandler"); 


EventManager* pEventManager = EventManager: :GetSingletonPtr(); 
assert (pEventManager) ; 
if (pEventManager) 
{ 
pEventManager - >SendEventToHandler( 
eventId, *static_cast<EventHandler*>(eventHandler) ) ; 


CHAPTER 21: Practical Template Programming 215 


e e 


template <typename T> 
inline void AttachEvent(EventID eventId, T* eventHandler) 
{ 
static_assert(std::is_base_of<EventHandler, T>::value, 
"Class provided is not derived from EventHandler"); 


EventManager* pEventManager = EventManager: :GetSingletonPtr(); 
assert(pEventManager); 
if (pEventManager) 


{ 
} 


pEventManager->AttachEvent(eventId, *static_cast<EventHandler*>(eventHandler)); 


} 


template <typename T> 
inline void DetachEvent(EventID eventId, T* eventHandler) 
{ 
static_assert(std::is_base_of<EventHandler, T>::value, 
"Class provided is not derived from EventHandler"); 


EventManager* pEventManager = EventManager: :GetSingletonPtr(); 
assert (pEventManager) ; 
if (pEventManager) 


{ 
} 


pEventManager->DetachEvent(eventId, *static_cast<EventHandler*>(eventHandler)); 


} 
The important line in these three methods is the static_assert and the code it contains: 


static_assert(std::is_base_of<EventHandler, T>::value, "Class provided is not derived from EventHandler"); 


The is_base_of keyword is actually a C++11 built-in template metaprogram. It is used to 
determine at compile time if a type is derived from another. In our case we supply a type to the 
templates using the typename T syntax as usual and then we pass this type T into the second 
parameter of is_base_of. The template compiler will calculate if the EventHandler class is a parent 
of the supplied class and set the value variable to be either true or false. Using this template 
metaprogram ensures that we can never attach or detach objects that are not derived from 
EventHandler by combining it with static_assert, which will throw an error when we are building 
our game. 


The EventManager class is complete, but before you can use it lm going to show you how you can 
write your own template metaprogram to calculate unique event IDs. 
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Calculating SDBM Hash Values Using a Template 
Metaprogram 


The SDBM hash algorithm is used to turn a stream of bytes into an integer representation. The 
algorithm has a very low chance of producing the same value for two different sets of data, which 
makes it ideal for our purposes. It’s also really easy to implement in C++, as you can see in 
Listing 21-17. 


Listing 21-17. The SDBM Hash Function 


inline unsigned int SDBMHash(const std::string& key) 


{ 
unsigned int result = 0; 
for (unsigned int i = 0; i < key.length(); ++i) 
int c = key[i]; 
result = c + (result << 6) + (result << 16) - result; 
} 
return result; 
} 


The algorithm iterates over the data, in this case a string, and uses the value of each character in an 
additive algorithm that manipulates the current result using bit shifts and subtractions. The problem 
with this function as implemented is that it will execute at runtime. This might be desired for some of 
our data; however, for any constexpr values that we know of at compile time it would be much better 
to preprocess the hashes. This makes the function a perfect target for template metaprogramming. 
Listing 21-18 shows the code that achieves this. 


Listing 21-18. The SDBMCalculator Template Metaprogram 


template <int stringLength> 
struct SDBMCalculator 


{ 

static inline int Calculate(const char* const stringToHash, int& value) 

{ 
int character = 

SDBMCalculator<stringLength - 1>::Calculate(stringToHash, value); 

value = character + (value << 6) + (value << 16) - value; 
return stringToHash[stringLength - 1]; 

static inline int CalculateValue(const char* const stringToHash) 

{ 
int value = 0; 
int character = SDBMCalculator<stringLength>: :Calculate(stringToHash, value); 
value = character + (value << 6) + (value << 16) - value; 
return value; 

} 


}3 
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template <> 
struct SDBMCalculator<1> 


{ 
static inline int Calculate(const char* const stringToHash, int& value) 
{ 
return stringToHash[0]; 
} 
} 


This code is going to be a little tricky for new C++ programmers to get their head around. Listing 21-19 
shows how this code would be used in your code. 


Listing 21-19. Using the SDBMCalculator Template Metaprogram 


constexpr int QuitEvent = SDBMCalculator<9>::CalculateValue("QuitEvent"); 


The template metaprogram is passed the length of the string as its template parameter and the string 
to hash as a function parameter. The static CalculateValue function is the function that is called. 
This function then calls the static Calculate method in the SDBMCalculator struct. You can see 
that the Calculate method calls itself. This is the very nature of template metaprogramming: The 
programs generally consist of recursive function calls. The Calculate method calls Calculate on an 
SDBMCalculator template, which is passed stringLength - 1 as its parameter. 


Our QuitEvent string has a length of 9 so the template metaprogram will recurse down until Calculate 
can hit the terminating condition. You can see the terminating condition in the specialized version 

of the struct. This struct doesn’t have any template parameters, but its Calculate function has a 
hard-coded parameter of 1. This specialized version of the function does not call any other version of 
Calculate so the calls begin to unwind at this point. If we were to print out the character and value 
after each step, the output would be: 


Q 
81 


u 

5313636 

i 
676857093 


t 
-223462225 


E 
-175116458 


V 
1572988576 


e 
-111689275 
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n 
509456361 


t 
687295179 


This works because the stringLength passed to each SDBMCalculator template is used to index into 
the string with 1 subtracted. Then as we start with the length of the string calling the SDBMCalculate 
method recursively down until we hit 1, we access the characters in the string in order. 


Template metaprogramming can be hard to understand when you’re just learning C++. Don’t worry 
about that too much for now. Come back to this code in the future when you’re ready to tackle some 
more template metaprogramming. 


We’ll update our QuitOption to use messages now that we can create a unique ID for the QuitEvent. 


Using an Event to Quit the Game 


Using an event to quit the game is relatively straightforward. To begin we’ll update the 
QuitOption: :Evaluate method to send the QuitEvent. Listing 21-20 shows how this is done. 


Listing 21-20. Updating QuitOption: : Evaluate 


namespace 
constexpr int QuitEvent = SDBMCalculator< >::CalculateValue("QuitEvent") ; 
} 

void QuitOption: :Evaluate(Player& player) 

SendEvent (QuitEvent) ; 

} 


You can finally see the benefit of using the friend functions with the EventManager, as sending the 
QuitEvent is just a single line of code! 


The main change required is to inherit the Game class from EventHandler as shown in Listing 21-21. 


Listing 21-21. Updating the Game Class 


class Game 
: public EventHandler 
{ 


private: 
static const unsigned int m_numberOfRooms = 4; 
using Rooms = std::array<Room, m_numberOfRooms>; 
Rooms m_rooms; 


Player m_player; 
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AttackEnemyOption m_attackDragonOption; 
AttackEnemyOption m_attackOrcOption; 
MoveOption m_moveNorthOption; 
MoveOption m_moveEastOption; 

MoveOption m_moveSouthOption; 
MoveOption m_moveWestOption; 
OpenChestOption m_openSwordChest; 
QuitOption m_quitOption; 


Sword m_sword; 
Chest m_swordChest; 


Enemy m_dragon; 
Enemy m_orc; 


bool m_playerQuit{ false }; 


void InitializeRooms(); 

void WelcomePlayer(); 

void GivePlayerOptions() const; 

void GetPlayerInput(std::stringstream& playerInput) const; 
void EvaluateInput(std::stringstream& playerInput) ; 


public: 

Game () ; 

void RunGame() ; 

virtual void HandleEvent(const Event* pEvent); 
3 


The three bold lines are the only changes to the class definition. It is now derived from the 
EventHandler interface and overrides the HandleEvent method. There is also a bool, m_playerQuit, 
used to store whether the player has chosen to quit, which is initialized to false. 


Listing 21-22 shows the changes that are needed in the Game: :RunGame method. 


Listing 21-22. Updating Game : :RunGame 


void Game: :RunGame() 
{ 


new EventManager(); 


RegisterEvent(QuitEvent) ; 
AttachEvent(QuitEvent, this); 


InitializeRooms(); 


WelcomePlayer(); 
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bool playerWon = false; 
while (m_playerQuit == false && playerWon == false) 


GivePlayerOptions(); 


stringstream playerInputStream; 
GetPlayerInput (playerInputStream) ; 


EvaluateInput(playerInputStream) ; 


playerWon = m_dragon.IsAlive() == false && m_orc.IsAlive() == false; 


} 
if (playerWon == true) 
{ 


cout << "Congratulations, you rid the dungeon of monsters!" << endl; 
cout << "Type goodbye to end" << endl; 

std::string input; 

cin >>input; 


} 


DetachEvent(QuitEvent, this); 
delete EventManager: :GetSingletonPtr(); 
} 


The RunGame method now has code to create an EventManager, to register the QuitEvent, and to 
attach itself as a listener for that event. The last two lines also detach from the event and delete the 
EventManager. The other main change is that EvaluateInput is no longer required to return the chosen 
option. We now catch the event in the HandleEvent method, which you can see in Listing 21-23. 


Listing 21-23. The Game: :HandleEvent Method 


void Game: :HandleEvent(const Event* pEvent) 


{ 
if (pEvent->GetID() == QuitEvent) 


m_playerQuit = true; 
} 


Handling events is really easy. You just need to check the ID of the Event and carry out the required 
action, which in this case is setting the m_playerQuit variable to true. If we had attached to more 
events we could have used else if statements to check against more EventIDs. 
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Summary 


This chapter has introduced you to some practical examples of template programming. You’ve seen 
how to use templates to create classes with variables with types that are determined at compile 
time. You’ve also seen how to create functions and methods that use templates. 


Using standard templates like this allows you to write generic class implementations that can be 
specialized with specific types at a later point in time. This is really useful to reduce the need to 
copy and paste code when you might have been tempted to re-create a class to store a different 
type of object. 


This chapter also introduced the topic of template metaprogramming. This is a complex and useful 
piece of C++ functionality but isn’t used in a lot of code. It can be hard for many programmers to 
understand and is seen as a relatively advanced topic. You saw in this chapter that C++ has some 
built-in template metaprograms such as is_base_of and you also saw how you can create your own 
template metaprograms. These programs are recursive in nature and can provide a good opportunity 
to optimize your code by shifting calculations from runtime to compile time. 


The next part of this book covers more general game programming topics, as this part has drawn 
the theoretical programming in C++ to a close. The next part covers design patterns, I/O streams, 
memory management, concurrent programming, and cross-platform game development. 


__ 


Part 


C++ Game Programming 


The previous parts of this book have mostly covered the theory of C++ programming with practical 
examples. This part of the book changes the focus to cover more general game development 
problems and how you can use the C++ features you’ve seen in action to solve those problems. 


This part of the book introduces concepts from game development such as memory management, 
design patterns, IO, and concurrent programming. Hopefully these practical game development 
examples will encourage you to continue your journey and enter the world of professional game 
development. 


Chapter 2 2 


Managing Memory for Game 
Developers 


This chapter is the first in the last part of this book, which will cover general game development 
topics that are important for new programmers to attempt to grasp. The first of these chapters is 
going to introduce you to the C++ memory model and the implications of using different types 
of memory. 


Memory management is a very important topic in game development. All games go through a period 
in development where memory is running low and the art team would like some more for extra 
textures or meshes. The way memory is laid out is also vitally important to the performance of your 
game. Understanding when to use stack memory, when to use heap memory, and the performance 
implications of each are important factors in to being able to optimize your programs for cache 
coherency and data locality. Before you can understand how to approach those problems you will 
need to understand the different places where C++ programs can store their data. 


There are three places in C++ where you can store your memory: There is a static space for storing 
static variables, the stack for storing local variables and function parameters, and the heap (or free 
store) from where you can dynamically allocate memory for different purposes. 


Static Memory 


Static memory is handled by the compiler and there isn’t much to say about it. When you build your 
program using the compiler, it sets aside a chunk of memory large enough to store all of the static 
and global variables defined in your program. This includes strings that are in your source code, 
which are included in an area of static memory known as a string table. 


There’s not much else to say regarding static memory, so we’ll move on to discussing the stack. 


225 


226 CHAPTER 22: Managing Memory for Game Developers 


The C++ Stack Memory Model 


The stack is more difficult to understand. Every time you call a function, the compiler generates code 
behind the scenes to allocate memory for the parameters and local variables for the function being 
called. Listing 22-1 shows some simple code that we then use to explain how the stack operates. 


Listing 22-1. A Simple C++ Program 


void function2(int variable1) 


{ 
int variable2{ variable1 }; 
} 
void functioni(int variable) 
{ 
function2(variable) ; 
} 
int _tmain(int argc, _TCHAR* argv[]) 
{ 
int variable{ 0 }; 
function1(variable) ; 
return 0; 
i 


The program in Listing 22-1 is very simple: It begins with _tmain, which calls function1 which calls 
function2. Figure 22-1 illustrates what the stack would look like for the main function. 


_tmain: variable= 0 


The stack space for main is very simple. It has a single storage space for the local variable named 
variable. These stack spaces for individual functions are known as stack frames. When function1 is 
called, a new stack frame is created on top of the existing frame for tmain. Figure 22-2 shows this 
in action. 


Figure 22-1. The stack for_tmain 


function1.variable = _tmain.variable 


_tmain.variable = 0 


Figure 22-2. The added stack frame for function1 
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When the compiler creates the code to push the stack frame for function1 onto the stack it also 
ensures that the parameter variable is initialized with the value stored in variable from _tmain. This 
is how parameters are passed by value. Finally, Figure 22-3 shows the last stack frame for function2 
added to the stack. 


function2.variable1 = function1 .variable 


function2.variable2 = function2.variable1 


function1.variable = _tmain.variable 
_tmain.variable = 0 


Figure 22-3. The complete stack frame 


The last stack frame is a little more complicated but you should be able to see how the literal 
value 0 in _tmain has been passed all the way along the stack until it is eventually used to initialize 
variable2 in function2. 


The remaining stack operations are relatively simple. When function2 returns the stack frame 
generated for that call is popped from the stack. This leaves us back at the state presented in 
Figure 22-2, and when function1 returns we are back at Figure 22-1. That’s all you need to know to 
understand the basic functionality of a stack in C++. 


Unfortunately things aren’t actually this simple. The stack in C++ is a very complicated thing to fully 
understand and requires a bit of assembly programming knowledge. That topic is outside the scope 
of a book aimed at beginners, but it’s well worth pursuing once you have a grasp of the basics. The 
article “Programmers Disassemble” in the September 2012 edition of Game Developer Magazine is 
an excellent introductory article on the operation of the x86 stack and well worth a read, available 
free from http://www. gdcvault.com/gdmag. 


This chapter hasn’t covered the ins and outs of how references and pointers are handled on the 
stack or how return values are implemented. Once you begin to think about this, you might begin to 
understand how complicated it can be. You might also be wondering why it’s useful to understand 
how the stack works. The answer lies in trying to work out why your game has crashed once it is in 
a live environment. It’s relatively easy to work out why a game crashes while you are developing, as 
you can simply reproduce the crash in a debugger. On games that have launched, you might receive 
a file known as a crash dump, which does not have any debugging information and simply has the 
current state of the stack to go on. At that point you need to look out for the symbol files from the 
build that let you work out the memory addresses of the functions that have been called, and you 
can then manually work out which functions have been called from the addresses in the stack and 
also try to figure out which function passed along an invalid memory address of value on the stack. 


This is complicated and time-consuming work, but it does come up every so often in professional 
game development. Services such as Crashlytics for iOS and Android or BugSentry for Windows PC 
programs can upload crash dumps and provide a call stack for you on a web service to help alleviate 
a lot of the pain from trying to manually work out what is going wrong with your game. 


The next big topic in memory management in C++ is the heap. 
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Working with Heap Memory 


So far in this book | have avoided using dynamic memory as much as possible because manually 
managing dynamically allocated memory is sometimes challenging, slower than using stack memory, 
and also very often unnecessary. Managing dynamic memory will become more important for you 
once you advance to writing games that load data from external files, as it’s often impossible to 

tell how much memory you’ll need at compile time. The very first game | worked on prevented 
programmers from allocating dynamic memory altogether. We worked around this by allocating 
arrays of objects and reusing memory in these arrays when we ran out. This is one way to avoid the 
performance cost of allocating memory. 


Allocating memory is an expensive operation because it has to be done in a manner that prevents 
memory corruption where possible. This is especially true on modern multiprocessor CPU 
architectures where multiple CPUs could be trying to allocate the same memory at the same time. 
This chapter, like the last, is not intended to be an exhaustive resource on the topic of memory 
allocation techniques for game development, but instead introduces the concept of managing 
heap memory. 


You saw the use of the new and delete operators in Chapter 21 when creating the Singleton 
EventManager object. Listing 22-2 shows a simple program using the new and delete operators. 


Listing 22-2. Allocating Memory for a class Dynamically 


class Simple 


{ 
private: 
int variable{ 0 }; 
public: 
Simple() 
{ 
std::cout << "Constructed" << std::endl; 
} 
~Simple() 
{ 
std::cout << "Destroyed" << std::endl; 
} 
}; 


int _tmain(int argc, _TCHAR* argv[]) 

{ 
Simple* pSimple = new Simple(); 
delete pSimple; 
pSimple = nullptr; 


return 0; 
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This simple program shows new and delete in action. When you decide to allocate memory in C++ 
using the new operator, the amount of memory required is calculated automatically. The new operator 
in Listing 22-2 will reserve enough memory to store the Simple object along with its member 
variables. If you were to add more members to Simple or inherit it from another class, the program 
would still operate and enough memory would be reserved for the expanded class definition. 


The new operator returns a pointer to the memory that you have requested to allocate. Once you 
have a pointer to memory that has been dynamically allocated, you are responsible for ensuring that 
the memory is also freed appropriately. You can see that this is done by passing the pointer to the 
delete operator. The delete operator is responsible for telling the operating system that the memory 
we reserved is no longer in use and can be used for other purposes. A last piece of housekeeping 

is then carried out when the pointer is set to store nullptr. By doing this we help prevent our code 
from assuming the pointer is still valid and that we can read and write from the memory as though 

it is still a Simple object. If your programs are crashing in seemingly random and inexplicable ways, 
accessing freed memory from pointers that have not been cleared is a common suspect. 


The standard new and delete operators are used when allocating single objects; however, there 
are also specific new and delete operators that should be used when allocating and freeing arrays. 
These are shown in Listing 22-3. 


Listing 22-3. Array new and delete 


int* pIntArray = new int[16]; 
delete[] pIntArray; 


This call to new will allocate 64 bytes of memory to store 16 int variables and return a pointer to the 
address of the first element. Any memory you allocate using the new[ ] operator should be deleted 
using the delete| ] operator, because using the standard delete can result in not all of the memory 
you requested being freed. 


Note Not freeing memory and not freeing memory properly is known as a memory leak. Leaking memory 
in this fashion is bad, as your program will eventually run out of free memory and crash because it eventually 
won’t have any available to fulfill new allocations. 


Hopefully you can see from this code why it’s beneficial to use the available STL classes to avoid 
managing memory yourself. If you do find yourself in a position of having to manually allocate 
memory, the STL also provides the unique_ptr and shared_ptr templates to help delete the memory 
when appropriate. Listing 22-4 updates the code from Listing 22-2 and Listing 22-3 to use unique_ptr 
and shared_ptr objects. 
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Listing 22-4. Using unique_ptr and shared_ptr 


#include <memory> 


class Simple 


{ 


private: 
int variable{ 0 }; 


public: 
Simple() 


std::cout << "Constructed" << std::endl; 


} 
~Simple() 
std::cout << "Destroyed" << std::endl; 
}; 


int _tmain(int argc, _TCHAR* argv[]) 

{ 
using UniqueSimplePtr = std::unique_ptr<Simple>; 
UniqueSimplePtr pSimple1{ new Simple() }; 
std::cout << pSimple1.get() << std::endl; 


UniqueSimplePtr pSimple2; 
pSimple2.swap(pSimple1); 
std::cout << pSimple1.get() << std::endl; 
std::cout << pSimple2.get() << std::endl; 


using IntSharedPtr = std::shared_ptr<int>; 
IntSharedPtr pIntArray1{ new int[16] }; 
IntSharedPtr pIntArray2{ pIntArray1 }; 


std::cout << std::endl << pIntArray1.get() << std::endl; 
std::cout << pIntArray2.get() << std::endl; 


return 0; 


} 


As the name suggests, unique_ptr is used to ensure that you only have a single reference to 
allocated memory at a time. Listing 22-3 shows this in action. pSimple1 is assigned a new Simple 
pointer and pSimple2 is then created as empty. You can try initializing pSimple2 by passing it 
pSimple1 or using an assignment operator and your code will fail to compile. The only way to pass 
the pointer from one unique_ptr instance to another is using the swap method. The swap method 
moves the stored address and sets the pointer in the original unique_ptr instance to be nullptr. 
The first three lines of output in Figure 22-4 show the addresses stored in the unique_ptr instances. 
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Figure 22-4. The output from Listing 22-4 


This output shows that the constructor from the Simple class is called. The pointer stored in 
pSimple1 is then printed out before the call to swap is made. After the call to swap pSimple1 stores a 
nullptr that is output as 00000000 and pSimple2 stores the address originally held there. The very 
final line of the output shows that the destructor for the Simple object has also been called. This is 
another benefit we receive from using unique_ptr and shared_ptr: Once the objects go out of scope 
then the memory is freed automatically. 


You can see from the two lines of output immediately before the line containing Destroyed that the 
two shared_ptr instances can store a reference to the same pointer. Only a single unique_ptr can 
reference a single memory location, but multiple shared_ptr instances can reference an address. 
The difference manifests itself in the timing of the delete call on the memory store. A unique_ptr will 
delete the memory it references as soon as it goes out of scope. It can do this because a unique_ptr 
can be sure that it is the only object referencing that memory. A shared_ptr, on the other hand, does 
not delete the memory when it goes out of scope; instead the memory is deleted when all of the 
shared_ptr objects pointing at that address are no longer being used. 


This does require a bit of discipline, as if you were to access the pointer using the get method on 
these objects then you could still be in a situation where you are referencing the memory after it has 
been deleted. If you are using unique_ptr or shared_ptr make sure that you are only passing the 
pointer around using the supplied swap and other accessor methods supplied by the templates and 
not manually using the get method. 


Writing a Basic Single Threaded Memory Allocator 


This section is going to show you how to overload the new and delete operators to create a very 
basic memory management system. This system is going to have a lot of drawbacks: It will store a 
finite amount of memory in a static array, it will suffer from memory fragmentation issues, and it will 
also leak any freed memory. This section is simply an introduction to some of the processes that 
occur when allocating memory, and it highlights some of the issues that make writing a fully featured 
memory manager a difficult task. 


232 CHAPTER 22: Managing Memory for Game Developers 


Listing 22-5 begins by showing you a structure that will be used as a header for our memory 
allocations. 


Listing 22-5. The MemoryAllocationHeader struct 


struct MemoryAllocationHeader 


{ 
void* pStart{ nullptr }; 
void* pNextFree{ nullptr }; 
size_t size{ 0 }; 

J 


This struct stores a pointer to the memory returned to the user in the pStart void* variable, 
a pointer to the next free block of memory in the pNextFree pointer, and the size of the allocated 
memory in the size variable. 


Our memory manager isn’t going to use dynamic memory to allocate memory to the user’s program. 
Instead it is going to return an address from inside a static array. This array is created in an unnamed 
namespace shown in Listing 22-6. 


Listing 22-6. The Unnamed namespace from Chapter22-MemoryAllocator. cpp 


namespace 
{ 

const unsigned int ONE_MEGABYTE = 1024 * 1024 * 1024; 

char pMemoryHeap[ONE_ MEGABYTE ]; 

const size t SIZE_OF MEMORY HEADER = sizeof(MemoryAllocationHeader) ; 


} 


Here you can see that we allocate a static array of 1 MB in size. We know that this is 1 MB as the 
char type is one byte in size on most platforms and we are allocating an array that is 1,024 bytes 
times 1,024 KB in size for a total of 1,048,576 bytes. The unnamed namespace also has a constant 
storing the size of our MemoryAllocationHeader object, calculated using the sizeof function. This 
size is 12 bytes: 4 bytes for the pStart pointer, 4 bytes for the pNextFree pointer, and 4 bytes for the 
size variable. 


The next important piece for code overloads the new operator. The new and delete functions that 
you have seen so far are just functions that can be hidden in the same way you can hide any other 
function with your own implementation. Listing 22-7 shows our new function. 


Listing 22-7. The Overloaded new Function 


void* operator new(size t size) 
{ 
MemoryAllocationHeader* pHeader = 
reinterpret_cast<MemoryAllocationHeader*>(pMemoryHeap) ; 
while (pHeader != nullptr && pHeader->pNextFree != nullptr) 


pHeader = reinterpret_cast<MemoryAllocationHeader*>(pHeader->pNextFree) ; 


CHAPTER 22: Managing Memory for Game Developers 233 


pHeader->pStart = reinterpret_cast<char*>(pHeader )+SIZE_OF_MEMORY_HEADER; 
pHeader->pNextFree = reinterpret_cast<char*>(pHeader->pStart) + size; 
pHeader->size = size; 


return pHeader->pStart; 


} 


The new operator is passed the size of the allocation we would like to reserve and returns a void* 
to the beginning of the block of memory to which the user can write. The function begins by looping 
over the existing memory allocations until it finds the first allocated block with a nullptr in the 
pNextFree variable. 


Once it finds a free block of memory, the pStart pointer is initialized to be the address of the free 
block plus the size of the memory allocation header. This ensures that every allocation also includes 
space for the pStart and pNextFree pointer and the size of the allocation. The new function ends by 
returning the value stored in pHeader->pStart ensuring that the user doesn’t know anything about 
the MemoryAllocationHeader struct. They simply receive a pointer to a block of memory of the size 
they requested. 


Once we have allocated memory, we can also free that memory. The overloaded delete operator 
clears the allocations from our heap in Listing 22-8. 


Listing 22-8. The Overloaded delete Function 


void operator delete(void* pMemory) 


{ 
MemoryAllocationHeader* pLast = nullptr; 
MemoryAllocationHeader* pCurrent = 
reinterpret_cast<MemoryAllocationHeader*>(pMemoryHeap) ; 
while (pCurrent != nullptr && pCurrent->pStart != pMemory) 


pLast = pCurrent; 
pCurrent = reinterpret_cast<MemoryAllocationHeader*>(pCurrent->pNextFree) ; 


} 
if (pLast != nullptr) 


pLast->pNextFree = reinterpret_cast<char*>(pCurrent->pNextFree) ; 


} 


pCurrent->pStart = nullptr; 
pCurrent->pNextFree = nullptr; 
pCurrent->size = 0; 


} 


This operator traverses the heap using two pointers, pLast and pCurrent. The heap is traversed until 
the pointer passed in pMemory is matched against an allocated memory block stored in the pStart 
pointer in a MemoryAllocationHeader struct. Once we find the matching allocation we set the 
pNextFree pointer to the address stored in pCurrent->pNextFree. This is the point at which we create 
two problems. We have fragmented our memory by freeing memory potentially between two other 
blocks of allocated memory, meaning that only an allocation of the same size or smaller can be filled 
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from this block. In this example, the fragmentation is redundant because we have not implemented 
any way of tracking our free blocks of memory. One option would be to use a list to store all of 

the free blocks rather than storing them in the memory allocation headers themselves. Writing a 
full-featured memory allocator is a complicated task that could fill an entire book. 


Note You can see that we have a valid case for using reinterpret_cast in our new and delete 
operators. There aren’t many valid cases for this type of cast. In this case we want to represent the same 
memory address using a different type and therefore the reinterpret_cast is the correct option. 


Listing 22-9 contains the last memory function for this section and it is used to print out the contents 
of all active MemoryAllocationHeader objects in our heap. 


Listing 22-9. The PrintAllocations Function 


void PrintAllocations() 


{ 


MemoryAllocationHeader* pHeader = 
reinterpret_cast<MemoryAllocationHeader*>(pMemoryHeap); 


while (pHeader != nullptr) 
std::cout << pHeader << std::endl; 
std::cout << pHeader->pStart << std::endl; 
std::cout << pHeader->pNextFree << std::endl; 
std::cout << pHeader->size << std::endl; 
pHeader = reinterpret_cast<MemoryAllocationHeader*>(pHeader->pNextFree); 


std::cout << std::endl << std::endl; 


} 


This function loops over all of the valid MemoryAllocationHeader pointers in our head and prints 
their pStart, pNextFree, and size variables. Listing 22-10 shows an example main function that uses 
these functions. 


Listing 22-10. Using the Memory Heap 


int _tmain(int argc, _TCHAR* argv[]) 

{ 
memset(pMemoryHeap, O, SIZE OF MEMORY HEADER); 
PrintAllocations(); 


Simple* pSimple1 = new Simple(); 
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} 


PrintAllocations(); 


Simple* pSimple2 = new Simple(); 


PrintAllocations(); 


Simple* pSimple3 = new Simple(); 


PrintAllocations(); 


delete pSimple2; 
pSimple2 = nullptr; 


PrintAllocations(); 
pSimple2 = new Simple(); 
PrintAllocations(); 


delete pSimple2; 
pSimple2 = nullptr; 


PrintAllocations(); 


delete pSimple3; 
pSimple3 = nullptr; 


PrintAllocations(); 


delete pSimple1; 
pSimple1 = nullptr; 


PrintAllocations(); 


return 0; 


This is a very simple function. It begins by using the memset function to initialize the first 12 bytes of 
the memory heap. memset works by taking an address, then a value to use, then the number of bytes 
to set. Each byte is then set to the value of the byte passed as the second parameter. In our case we 


are setting the first 12 bytes of pMemoryHeap to 0. 


We then have our first call to PrintAllocations and the output from my run is the following. 


0x00870320 
0x00000000 
0x00000000 


0 
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The first line is the address of the MemoryAllocationHeader struct, which for our first call is also the 
address stored in pMemoryHeap. The next line is the value stored in pStart, then pNextFree, then size. 
These are all 0 as we have not yet made any allocations. The memory addresses are being printed as 
32-bit hexadecimal values. 


Our first Simple object is then allocated. It turns out that because the Simple class only contains 
a single int variable, we only need to allocate 4 bytes to store it. The output from the second 
PrintAllocations call confirms this. 


Constructed 
0x00870320 
0x0087032C 
0x00870330 
4 


0x00870330 
0x00000000 
0x00000000 
0 


We can see the Constructed text, which was printed in the constructor for the Simple class and then 
that our first MemoryAllocationHeader struct has been filled in. The address of the first allocation 
remains the same, as it is the beginning of the heap. The pStart variable stores the address from 

12 bytes after the beginning as we have left enough space to store the header. The pNextFree 
variable stores the address after adding the 4 bytes required to store the pSimple variable, and the 
size variable stores the 4 from the size passed to new. We then have the printout of the first free 
block, starting at 00870330, which is conveniently 16 bytes after the first. 


The program then allocates another two Simple objects to produce the following output. 


Constructed 
0x00870320 
0x0087032C 
0x00870330 
4 


0x00870330 
0x0087033C 
0x00870340 
4 


0x00870340 
0x0087034C 
0x00870350 
4 


0x00870350 
0x00000000 
0x00000000 
0 
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In this output you can see the three allocated 4-byte objects and each of the start and next 
addresses in each allocation header. The output is updated again after deleting the second object. 


Destroyed 
0x00870320 
0x0087032C 
0x00870340 
4 


0x00870340 
0x0087034C 
0x00870350 
4 


0x00870350 
0x00000000 
0x00000000 
0 


The first allocated object now points to the third and the second allocated object has been removed 
from the heap. A fourth object is allocated just to see what would happen. 


Constructed 
0x00870320 
0x0087032C 
0x00870340 
4 


0x00870340 
0x0087034C 
0x00870350 
4 


0x00870350 
0x0087035C 
0x00870360 
4 


0x00870360 
0x00000000 
0x00000000 
0 


At this point pSimple1 is stored at address 0x0087032C, pSimple2 is at 0x0087035C, and pSimple3 is at 
0x0087034C. The program then ends by deleting each allocated object one by one. 


Despite the problems that would prevent you from using this memory manager in production code, 
it does serve as a useful example of how a heap operates. Some method of tracking allocations is 
used so that the memory management system can tell which memory is in use and which memory is 
free to be allocated. 
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Summary 


This chapter has given you a very simple introduction to the C++ memory management model. 
You’ve seen that your programs will use static memory, stack memory, and heap memory to store 
the objects and data to be used by your games. 


Static memory and stack memory are handled automatically by the compiler, and you’ve already 
been using these types of memory throughout this book without having to do anything in particular. 
Heap memory has higher management overhead, as it requires that you also free the memory 
once you have finished using it. You’ve seen that the STL provides the unique_ptr and shared_ptr 
templates to help automatically manage dynamic memory allocations. Finally, you were introduced 
to a simple memory manager. This memory manager would be unsuitable for production code, but 
it does provide you with an overview of how memory is allocated from a heap and how you can 
overload the global new and delete methods to hook in your own memory manager. 


Extending this memory manager to be fully featured would involve adding support for reallocating 
freed blocks, defragmenting contiguous free blocks in the heap, and eventually ensuring the 
allocation system is thread safe. Modern games also tend to create multiple heaps to serve different 
purposes. It’s not uncommon for games to create memory allocators to handle mesh data, textures, 
audio, and online systems. There could also be thread-safe allocators and allocators that are not 
thread safe that can be used in situations where memory accesses will not be made by more than 
one thread. Complex memory management systems also have small block allocators to handle 
memory requests below a certain size to help alleviate memory fragmentation, which could be 
caused by frequent small allocations made by the STL for string storage, and so on. As you can see, 
the topic of memory management in modern games is a far more complex problem than can be 
covered in this chapter alone. 
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Chapter 


Useful Design Patterns for Game 
Development 


Design patters are like blueprints for your code. They are systems you can use to complete tasks 
that are very similar in nature that arise while you are developing games. Just as STL data structures 
are reusable collections that can be used when needed to solve specific problems, design patterns 
can be utilized to solve logical problems in your code. 


There are benefits to using design patterns in your game projects. First, they allow you to use a 
common language that many other developers will understand. This helps reduce the length of time 
it takes new programmers to get up to speed when helping on your projects because they might 
already be familiar with the concepts you have used when building your game’s infrastructure. 


Design patterns can also be implemented using common code. This means that you can reuse this 
code for a given pattern. Code reuse reduces the number of lines of code in use in your game, which 
leads to a more stable and more easily maintainable code base, both of which mean you can write 
better games more quickly. 


You’ve already seen at least one design patter used in this book already. Chapter 21 showed how 
you could use a template class to create a Singleton object. You can think of a Singleton as a 
reusable logical object that provides you with the ability to ensure that only a single instance of a 
given class is created and accessed throughout your game code. This chapter introduces you to 
three more patterns: the Factory, the Observer and the Visitor. 


Using the Factory Pattern in Games 


The factory pattern is a useful way to abstract out the creation of dynamic objects at runtime. 

A factory for our purposes is simply a function that takes a type of object as a parameter and returns 
a pointer to a new object instance. The returned object is created on the heap and therefore it is the 
caller’s responsibility to ensure that the object is deleted appropriately. Listing 23-1 shows a factory 
method that | have created to instantiate the different types of Option objects used in Text Adventure. 
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Listing 23-1. A Factory for Creating Option Instances 


Option* CreateOption(PlayerOptions optionType) 


{ 
Option* pOption = nullptr; 
switch (optionType) 
case PlayerOptions: :GoNorth: 
pOption = new MoveOption( 
Room: : JoiningDirections: :North, 
PlayerOptions::GoNorth, "Go North"); 
break; 
case PlayerOptions: :GoEast: 
pOption = new MoveOption( 
Room: : JoiningDirections: :East, 
PlayerOptions::GoEast, "Go East"); 
break; 
case PlayerOptions: :GoSouth: 
pOption = new MoveOption( 
Room: : JoiningDirections: : South, 
PlayerOptions: :GoSouth, 
"Go South"); 
break; 
case PlayerOptions: :GoWest: 
pOption = new MoveOption( 
Room: : JoiningDirections: :West, 
PlayerOptions: :GoWest, 
"Go West"); 
break; 
case PlayerOptions: :OpenChest: 
pOption = new OpenChestOption("Open Chest"); 
break; 
case PlayerOptions: :AttackEnemy: 
pOption = new AttackEnemyOption(); 
break; 
case PlayerOptions: :Quit: 
pOption = new QuitOption("Quit"); 
break; 
case PlayerOptions: :None: 
break; 
default: 
break; 
} 
return pOption; 
} 


As you can see, the CreateOption factory function takes a PlayerOption enum as a parameter and 
then returns an appropriately constructed Option. This relies on polymorphism to return a base 
pointer for the object. The knock-on effect of this use of polymorphism is that any factory function 
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can only create objects that derive from its return type. Many game engines manage this by having 
all creatable objects derive from a common base class. For our purposes, in the context of learning, 
it’s better to cover a couple of examples. Listing 23-2 shows a factory for the Enemy derived classes. 


Listing 23-2. The Enemy Factory 


Enemy* CreateEnemy(EnemyType enemyType) 
{ 
Enemy* pEnemy = nullptr; 
switch (enemyType) 
{ 
case EnemyType: :Dragon: 
pEnemy = new Enemy(EnemyType: :Dragon) ; 
break; 
case EnemyType: :Orc: 
pEnemy = new Enemy(EnemyType: :Orc); 
break; 
default: 
assert(false); // Unknown enemy type 
break; 
} 


return pEnemy; 


} 


If you were to create new inherited classes for these enemy types at some point in the future, you 
would only be required to update the factory function to add these new classes to your game. This is 
a handy feature of using factory methods to take advantage of polymorphic base classes. 


So far all of the Option and Enemy objects in Text Adventure have been member variables within the 
Game class. This doesn’t work too well with factory objects because the factory will create the objects 
on the heap, not using stack memory; therefore the Game class must be updated to store pointers to 
the Option and Enemy instances. You can see how this is done in Listing 23-3. 


Listing 23-3. Updating Game to Store Pointers to Option and Enemy Instances 


class Game 
: public EventHandler 
{ 


private: 
static const unsigned int m_numberOfRooms = 4; 
using Rooms = std::array<Room::Pointer, m_numberOfRooms> ; 
Rooms m_rooms; 


Player m_player; 


Option: :Pointer m_attackDragonOption; 
Option: :Pointer m_attackOrcOption; 
Option: :Pointer m_moveNorthOption; 
Option: :Pointer m_moveEastOption; 
Option: :Pointer m_moveSouthOption; 
Option: :Pointer m_moveWestOption; 
Option: :Pointer m_openSwordChest; 
Option: :Pointer m_quitOption; 
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Sword m_sword; 
Chest m_swordChest; 


using Enemies = std::vector<Enemy: :Pointer> ; 
Enemies m_enemies; 


bool m playerQuit{ false }; 


void InitializeRooms(); 

void WelcomePlayer(); 

void GivePlayerOptions() const; 

void GetPlayerInput(std::stringstream& playerInput) const; 
void EvaluateInput(std::stringstream& playerInput) ; 


public: 

Game () ; 

void RunGame() ; 

virtual void HandleEvent(const Event* pEvent); 
5 


Game now references the Option and Enemy instances via a type alias that is defined in the respective 
Option and Enemy class definitions. These aliases are shown in Listing 23-4. 


Listing 23-4. The Option: : Pointer and Enemy: : Pointer Type Aliases 


class Option 
{ 
public: 
using Pointer = std::shared_ptr<Option>; 


protected: 
PlayerOptions m_chosenOption; 
std::string m_outputText; 


public: 
Option(PlayerOptions chosenOption, const std::string& outputText) 
: m_chosenOption(chosenOption) 
» m outputText (outputText) 


{ 

} 

const std::string& GetOutputText() const 
i return m_outputText; 

} 


virtual void Evaluate(Player& player) = 0; 
}; 
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class Enemy 
: public Entity 


{ 
public: 
using Pointer = std::shared_ptr<Enemy>; 
private: 
EnemyType m_type; 
bool m alive{ true }; 
public: 
Enemy(EnemyType type) 
: m_type{ type } 
{ 
} 
EnemyType GetType() const 
return m_type; 
} 
bool IsAlive() const 
{ 
return m_alive; 
} 
void Kill() 
{ 
m_alive = false; 
} 
}; 


The Pointer aliases in both classes have been defined using the shared_ptr template. This 

means that once the instances have been created by the factories you will not need to worry about 
where the objects should be deleted. The shared_ptr will automatically delete the instance as soon 
as you no longer hold a shared_ptr reference. 


Updating the Game class constructor is the next important change when using the two factory 
functions. This constructor is shown in Listing 23-5. 


Listing 23-5. The Updated Game Constructor 


Game: : Game ( ) 
: m_attackDragonOption{ CreateOption(PlayerOptions: :AttackEnemy) } 
» m_attackOrcOption{ CreateOption(PlayerOptions: :AttackEnemy) } 
» m _moveNorthOption{ CreateOption(PlayerOptions::GoNorth) } 
» m _moveEastOption{ CreateOption(PlayerOptions::GoEast) } 
» m _moveSouthOption{ CreateOption(PlayerOptions::GoSouth) } 
» m _moveWestOption{ CreateOption(PlayerOptions::GoWest) } 
» m openSwordChest{ CreateOption(PlayerOptions::OpenChest) } 
» m _quitOption{ CreateOption(PlayerOptions: :Quit) } 
» m_swordChest{ &m_sword } 


244 CHAPTER 23: Useful Design Patterns for Game Development 


{ 
static_cast<OpenChestOption*>(m_openSwordChest.get())->SetChest(&m_swordChest) ; 
m_enemies.emplace_back(CreateEnemy(EnemyType: :Dragon) ) ; 
static_cast<AttackEnemyOption*>(m_attackDragonOption.get())->SetEnemy(m_enemies[0]); 
m_enemies.emplace_back(CreateEnemy(EnemyType: :Orc)); 
static_cast<AttackEnemyOption*>(m_attackOrcOption.get())->SetEnemy(m_enemies[1]); 

} 


The constructor now calls the factory methods to create the proper instances needed to initialize the 
shared_ptr for each Option and Enemy. Each Option has its own pointer, but the Enemy instances are 
now placed into a vector using the emplace_back method. I’ve done this to show you how you can 
use the shared_ptr::get method along with static_cast to convert the polymorphic base class to 
the derived class needed to add the Enemy. The same type of cast is needed to add the address of 
m_swordChest to the m_openSwordChest option. 


That’s all there is to creating basic factory functions in C++. These functions come into their own 
when writing level loading code. Your data can store the type of object you’d like to create at any 
given time and just pass it into a factory that knows how to instantiate the correct object. This 
reduces the amount of code in your loading logic, which can help reduce bugs! This is definitely a 
worthwhile goal. 


Decoupling with the Observer Pattern 


The observer pattern is very useful in decoupling your code. Coupled code is code that shares too 
much information about itself with other classes. This could be specific methods in its interface or 
variables that are exposed between classes. Coupling has a couple of major drawbacks. The first 
is that it increases the number of places where your code must be updated when making changes 
to exposed methods or functions and the second is that your code becomes much less reusable. 
Coupled code is less reusable because you have to take over any coupled and dependent classes 
when deciding to reuse just a single class. 


Observers help with decoupling by providing an interface for classes to derive which provide 

event methods that will be called on objects when certain changes happen on another class. The 
Event system introduced earlier had an informal version of the observer pattern. The Event class 
maintained a list of listeners that had their HandleEvent method called whenever an event they were 
listening for was triggered. The observer pattern formalizes this concept into a Notifier template 
class and interfaces that can be used to create observer classes. Listing 23-6 shows the code for 
the Notifier class. 


Listing 23-6. The Notifier Template Class 


template <typename Observer> 

class Notifier 

{ 

private: 
using Observers = std::vector<Observer*>; 
Observers m_observers; 
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public: 
void AddObserver(Observer* observer); 
void RemoveObserver(Observer* observer) ; 
template <void (Observer: :*Method) ()> 
void Notify(); 

3 


The Notifier class defines a vector of pointers to Observer objects. There are complementary 
methods to add and remove observers to the Notifier and finally a template method named Notify, 
which will be used to notify Observer objects of an event. Listing 23-7 shows the AddObserver and 
RemoveObserver method definitions. 


Listing 23-7. The AddObserver and RemoveObserver method definitions 


template <typename Observer> 

void Notifier<Observer>: :AddObserver(Observer* observer) 

{ 
assert(find(m_observers.begin(), m_observers.end(), observer) == m_observers.end()); 
m_observers.emplace_back(observer) ; 


} 


template <typename Observer> 
void Notifier<Observer>: :RemoveObserver(Observer* observer) 


{ 
auto object = find(m_observers.begin(), m_observers.end(), observer); 
if (object != m_observers.end()) 
{ 
m_observers.erase(object) ; 
} 
} 


Adding an Observer is as simple as calling emplace_back on the m_ observers vector. The assert is 
used to inform us if we are adding more than one copy of each Observer to the vector. The remove 
is achieved by using find to get an iterator to the object to be removed and calling erase if the 
iterator is valid. 


The Notify method uses a C++ feature that you have not seen so far, method pointers. A method 
pointer allows us to pass the address of a method from a class definition that should be called on a 
specific object. Listing 23-8 contains the code for the Notify method. 


Listing 23-8. The Notifier<Observer>: :Notify Method 


template <typename Observer> 
template <void(Observer: :*Method) ()> 
void Notifier<Observer>: :Notify() 


{ 
for (auto& observer : m observers) 
{ 
(observer->*Method) (); 
} 
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The Notify template method specifies a method pointer parameter. The method pointer must have a 
void return type and take no arguments. The type of a method pointer takes the following format. 


void (Class: :*VariableName) () 


Class here represents the name of the class the method belongs to and VariableName is the name 
we use to reference the method pointer in our code. You can see this in action in the Notify method 
when we call the method using the Method identifier. The object we are calling the method on here is 
an Observer* and the address of the method is dereferenced using the pointer operator. 


Once our Notifier class is complete, we can use it to create Notifier objects. Listing 23-9 inherits 
a Notifier into the QuitOption class. 
Listing 23-9. Updating QuitOption 


class QuitOption 
: public Option 
s public Notifier<QuitObserver> 


{ 
public: 
QuitOption(const std::string& outputText) 
: Option(PlayerOptions::Quit, outputText) 
{ 
} 
virtual void Evaluate(Player& player); 
}; 


QuitOption now inherits from the Notifier class, which is passed a new class as its template 
parameter. Listing 23-10 shows the QuitObserver class. 


Listing 23-10. The QuitObserver Class 


class QuitObserver 


{ 
public: 
virtual void OnQuit() = 0; 


}3 


QuitObserver is simply an interface that provides a method, OnQuit, to deriving classes. Listing 23-11 
shows how you should update the QuitOption: : Evaluate method to take advantage of the Notifier 
functionality. 


Listing 23-11. Updating QuitOption: :Notifier 


void QuitOption: :Evaluate(Player& player) 


Notify<&QuitObserver: :OnQuit>(); 
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Now you can see the very clean template method call. This simple call will call the OnQuit method on 
every object that has been added as an observer on the QuitOption. That’s our next step: The Game 
class is updated to inherit from QuitObserver in Listing 23-12. 


Listing 23-12. The Game Class QuitObserver 


class Game 
: public EventHandler 
» public QuitObserver 
{ 
private: 
static const unsigned int m_numberOfRooms = 4; 
using Rooms = std::array<Room::Pointer, m_numberOfRooms> ; 
Rooms m_rooms; 


Player m_player; 


Option: :Pointer m_attackDragonOption; 
Option: :Pointer m_attackOrcOption; 
Option: :Pointer m_moveNorthOption; 
Option: :Pointer m_moveEastOption; 
Option: :Pointer m_moveSouthOption; 
Option: :Pointer m_moveWestOption; 
Option: :Pointer m_openSwordChest; 
Option: :Pointer m_quitOption; 


Sword m_sword; 
Chest m_swordChest; 


using Enemies = std::vector<Enemy::Pointer>; 
Enemies m_enemies; 


bool m playerQuit{ false }; 


void InitializeRooms(); 

void WelcomePlayer(); 

void GivePlayerOptions() const; 

void GetPlayerInput(std::stringstream& playerInput) const; 

void EvaluateInput(std::stringstream& playerInput) ; 
public: 

Game () ; 

~Game(); 


void RunGame() ; 
virtual void HandleEvent(const Event* pEvent); 


// From QuitObserver 
virtual void OnQuit(); 


B 
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The bolded lines show that the Game class inherits from QuitObserver, now has a destructor, 
and overloads the OnQuit method. Listing 23-13 shows how the constructor and destructor are 
responsible for adding and removing the class as a listener to QuitOption. 


Listing 23-13.NThe Game Class Constructor and Destructor 


Game: :Game() 

: m_attackDragonOption{ CreateOption(PlayerOptions: :AttackEnemy) } 
m_attackOrcOption{ CreateOption(PlayerOptions::AttackEnemy) } 
m_moveNorthOption{ CreateOption(PlayerOptions::GoNorth) } 
m_moveEastOption{ CreateOption(PlayerOptions::GoEast) } 
m_moveSouthOption{ CreateOption(PlayerOptions::GoSouth) } 
m_moveWestOption{ CreateOption(PlayerOptions::GoWest) } 
m_openSwordChest{ CreateOption(PlayerOptions::OpenChest) } 

m quitOption{ CreateOption(PlayerOptions: :Quit) } 

m_swordChest{ &m sword } 


maw he he he we Ye we 


static_cast<OpenChestOption*>(m_openSwordChest.get())->SetChest(&m_swordChest) ; 


m_enemies.emplace_back(CreateEnemy(EnemyType: :Dragon)) ; 
static_cast<AttackEnemyOption*>(m_attackDragonOption.get())->SetEnemy(m_enemies[0]); 


m_enemies.emplace_back(CreateEnemy(EnemyType: :Orc)); 
static_cast<AttackEnemyOption*>(m_attackOrcOption.get())->SetEnemy(m_enemies[1]); 


static_cast<QuitOption*>(m_quitOption.get())->AddObserver(this) ; 


} 
Game: :~Game() 
{ 
static_cast<QuitOption*>(m_quitOption.get())->»RemoveObserver(this) ; 
} 


The bolded lines again show the relevant updates to the code. The last update in Listing 23-14 
implements the OnQuit method. 


Listing 23-14. The Game: :OnQuit Method 


void Game: :OnQuit() 
{ 


} 


m_playerQuit = true; 


This is all there is to implementing the observer pattern. This has achieved another decoupling 
between the QuitOption class and any other classes in the game that need to know about quit 
events. The observer class is especially useful when creating game framework code for systems 
such as online features. You can imagine a situation where you implement a class to download 
leaderboards from a web server. This class could be used in multiple game projects and each 
individual game could simply implement its own class to observe the downloader and act 
appropriately when the leaderboard data has been received. 
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Easily Adding New Functionality with the Visitor Pattern 


One of the main goals of writing reusable game engine code is to try to avoid including 
game-specific functionality in your classes. This can be hard to achieve with a pure object-oriented 
approach, as the aim of encapsulation is to hide the data in your classes behind interfaces. This 
could mean that you are required to add methods to classes to work on data that are very specific to 
a certain class. 


We can get around this problem by loosening our encapsulation on classes that must interact with 
game code, but we do so in a very structured manner. You can achieve this by using the visitor 
pattern. A visitor is an object that knows how to carry out a specific task on a type of object. These 
are incredibly useful when you need to carry out similar tasks on many objects that might inherit 
from the same base class but have different parameters or types. Listing 23-15 shows an interface 
class you can use to implement Visitor objects. 


Listing 23-15. The Visitor Class 


class Visitor 


{ 
private: 

friend class Visitable; 

virtual void OnVisit(Visitable& visitable) = 0; 
}; 


The Visitor class provides a pure virtual method OnVisit, which is passed an object that inherits 
from a class named Visitable. Listing 23-16 lists the Visitable class. 


Listing 23-16. The Visitable Class 


class Visitable 


{ 
public: 
virtual ~Visitable() {} 
void Visit(Visitor& visitor) 
{ 
visitor.OnVisit(*this) ; 
} 
3 


The Visitable class provides a Visit method that is passed the Visitor object. The Visit method 
calls the OnVisit method on the Visitor. This allows us to make the OnVisit method private, which 
ensures that only Visitable objects can be visited and that we are always passing a valid reference 
to the OnVisit method. 


The visitor pattern is very simple to set up. You can see a concrete example of how to use the 
pattern in Listing 23-17, where the Option class from Text Adventure has been inherited from 
Visitable. 
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Listing 23-17. The Updated Option Class 


class Option 
: public Visitable 


{ 
public: 
using Pointer = std::shared_ptr<Option>; 
protected: 
PlayerOptions m_chosenOption; 
std::string m_outputText; 
public: 
Option(PlayerOptions chosenOption, const std::string& outputText) 
: m_chosenOption(chosenOption) 
» m_outputText (outputText) 
{ 
} 
const std::string& GetOutputText() const 
{ 
return m_outputText; 
} 
virtual void Evaluate(Player& player) = 0; 
}; 


The only change required is to inherit the Option class from Visitable. To take advantage of this, 
a Visitor named EvaluateVisitor is created in Listing 23-18. 


Listing 23-18. The EvaluateVisitor Class 


class EvaluateVisitor 
: public Visitor 
{ 


private: 
Player& m player; 


public: 
EvaluateVisitor(Player& player) 
: m_player{ player } 
{ 


} 


virtual void OnVisit(Visitable& visitable) 


{ 
Option* pOption = dynamic_cast<Option*>(&visitable) ; 
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if (pOption != nullptr) 
{ 


pOption->Evaluate(m_player); 


} 


The EvaluateListener: :OnVisit method uses a dynamic_cast to determine if the supplied visitable 
variable is an object derived from the Option class. If it is, the Option: : Evaluate method is called. 
The only remaining update is to use the EvaluateVisitor class to interface with the chosen option in 
Game: :EvaluateInput. This update is shown in Listing 23-19. 


Listing 23-19. The Game: :EvaluateInput Method 


void Game: :EvaluateInput(stringstream& playerInputStream) 


{ 
PlayerOptions chosenOption = PlayerOptions: :None; 
unsigned int playerInputChoice{ 0 }; 
playerInputStream >>playerInputChoice; 
try 
{ 
Option: :Pointer option = 
m_player.GetCurrentRoom()->EvaluateInput (playerInputChoice) ; 
EvaluateVisitor evaluator{ m_player }; 
option->Visit (evaluator) ; 
} 
catch (const std::out_of_range&) 
{ 
cout << "I do not recognize that option, try again!" << endl << endl; 
} 
} 


As you can see, the code has been updated to call the Visit method on the Option rather than 
calling the Evaluate method directly. That’s all we needed to do to add the Visitor pattern to the 
Text Adventure game. 


This example isn’t the best use of the Visitor pattern, as it is relatively simple. Visitors can come 
into their own in places such as a render queue in 3-D games. You can implement different types of 
rendering operations in Visitor objects and use that to determine how individual games render their 
3-D objects. Once you get the hang of abstracting out logic in this way, you might find many places 
where being able to provide different implementations independently of the data is very useful. 


Summary 


This chapter has given you a brief introduction to the concept of design patterns. Design patterns 
are exceptionally useful as they provide a ready-made toolbox of techniques that can be used to 
solve many diverse problems. You’ve seen the Singleton, Factory, Observer, and Visitor patterns 
used in this book, but there are many, many more. 
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The de facto standard textbook on software engineering design patterns is Design Patterns: Elements of 
Reusable Object Oriented Software by Gamma, Helm, Johnson, and Vlissides (also known as the “Gang 
of Four”). If you find this concept interesting, you should read their book. It covers the examples 
shown here as well as other useful patterns. Bob Nystrom, a former software engineer at EA, has 
provided a free online collection of design patterns relevant to game development. You can find his 
web site here: http: //gameprogrammingpatterns.com/. 


You'll find many patterns relevant and helpful when trying to solve game development problems. 
They also make your code easier to work with for other developers who are also versed in the 
common techniques that design patterns provide. Our next chapter is going to look at C++ IO 
streams and how we can use them to load and save game data. 


Chapter 


Using File I0 to Save and 
Load Games 


Saving and loading game progress is a standard feature of all but the most basic games today. This 
means that you will need to Know how to handle the loading and saving of game objects. This chapter 
covers one possible strategy for writing out the data you will need to be able to reinstate a player’s game. 


First we look at the SerializationManager class, which uses the STL classes ifstream and ofstream 
to read and write from files. Then we cover how to update the Text Adventure game to be able to 
save which room the player is in, which items have been picked up, which enemies are dead, and 
which dynamic options have been removed. 


What Is Serialization? 


It would be good to cover what serialization is before we serialize the game’s different classes. 
Serialization in computer programming covers the process of converting data into a format that can 
be written out by the program and read in at a later point in time. There are three major systems in 
modern games that take advantage of serialization. 


The first is the save game system that will also be the basis for this chapter. Classes are serialized 
into a binary data file that can be read by the game at a later point in time. This type of serialization 
is essential for players to be able to retain their game data between different runs of the game and 
even on different computers. Transferring saved games between different machines is now a key 
feature of Xbox Live, PlayStation Network, Steam, and Origin. 


The second main use of serialization is in multiplayer gaming. Multiplayer games need to be able 
to convert game object state into a small a number of bytes as possible for transmission over 
the Internet. The program on the receiving end then needs to be able to reinterpret the stream 

of incoming data to update the position, rotation, and state of opponent players’ and projectiles. 
Multiplayer games are also required to serialize the win conditions of the round players are 
participating in so that winners and losers can be worked out. 
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The remaining systems are more useful during game development. Modern game toolsets and 
engines provide the ability to update game data at runtime. Player properties such as health or the 
amount of damage dealt by weapons can be updated by game designers while the game is running. 
This is made possible using serialization to convert data from the tool into a data stream that the 
game can then use to update its current state. This form of serialization can speed up the iteration 
process of game design. I’ve even worked with a tool that allows designers to update all of the 
current connected players in a multiplayer session midround. 


These aren’t the only forms of serialization you will encounter during game development, but they 
are likely to be the most common. This chapter focuses on serializing game data out and in using 
the C++ classes ofstream and ifstream. These classes provide the ability to serialize C++’s built-in 
types to and from files stored in your device’s file system. This chapter shows you how to create 
classes that are aware of how to write out and read in their data using ifstream and ofstream. It 
will also show you a method for managing which objects need to be serialized and how to refer to 
relationships between objects using unique object IDs. 


The Serialization Manager 


The SerializationManager class is a Singleton that is responsible for keeping track of every object 
in the game that can have its state streamed out or is referenced by another savable object. Listing 
24-1 covers the class definition for the SerializationManager. 


Listing 24-1. The SerializationManager Class 


class SerializationManager 
: public Singleton<SerializationManager> 
{ 


private: 
using Serializables = std::unordered_map<unsigned int, Serializable*>; 
Serializables m_serializables; 


const char* const m filename{"Save.txt"}; 


public: 
void RegisterSerializable(Serializable* pSerializable) ; 


void RemoveSerializable(Serializable* pSerializable) ; 
Serializable* GetSerializable(unsigned int serializableId) const; 
void ClearSave(); 

void Save(); 


bool Load(); 
}; 
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The SerializationManager class stores pointers to Serializable objects in an unordered_map. Each 
of the Serializable objects will be given a unique ID that is used as the key in this collection. The 
file name we would like to use for the save file is stored in the m_filename variable. 


There are three methods used to manage the objects that are handled by the SerializationManager 
class. The RegisterSerializable, RemoveSerializable, and GetSerializable methods are shown 
in Listing 24-2. 


Listing 24-2. The RegisterSerializable, RemoveSerializable, and GetSerializable Methods 


void SerializationManager: :RegisterSerializable(Serializable* pSerializable) 

{ 
assert(m serializables.find(pSerializable->GetId()) == m_serializables.end()); 
m_serializables.emplace{ pSerializable->GetId(), pSerializable }; 


} 
void SerializationManager: :RemoveSerializable(Serializable* pSerializable) 
{ 

auto iter = m serializables.find(pSerializable->GetId()); 

if (iter != m serializables.end()) 

{ 

m_serializables.erase(iter) ; 

} 

} 


Serializable* SerializationManager: :GetSerializable(unsigned int serializableId) const 


{ 
Serializable* pSerializable{ nullptr }; 
auto iter = m serializables.find(serializableId) ; 
if (iter != m serializables.end()) 


{ 
} 


return pSerializable; 


pSerializable = iter->second; 


} 


These methods are all fairly straightforward and manage adding, removing, and retrieving 
Serializable addresses from the m_serializables unordered_map. 


The Save method is responsible for looping over all of the Serializable objects and asking them to 
write their data to an ofstream object. Listing 24-3 shows the Save method and how the ofstream 
object is initialized and moved. 


Listing 24-3. The SerializableManager: : Save 


void SerializationManager: :Save() 

{ 
std::ofstream file{ m filename }; 
file << true; 
file << std::endl; 
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for (auto& serializable : m serializables) 
{ 
Serializable* pSerializable = serializable.second; 
file << pSerializable->GetId(); 
file << std::endl; 
pSerializable->OnSave(file) ; 


file << std::endl; 
file << std::endl; 


} 


An ofstream object is initialized by passing it the file name you wish to write to. You can then use the 
standard << operator to write data to the file. The o in ofstream stands for output, the f for file, and 
stream for its ability to stream data, meaning we are working with an output file stream. 


The Save method begins by writing out a true. This bool is used to determine if the save game has 
a reinstatable save game inside. We write out false later when the player has completed the game. 
Save then loops over all of the stored Serializable objects, writes out their unique ID, and calls the 
OnSave method. The std::endl is being written out just to make the text file a little more readable 
and easier to debug. 


The opposite action to Save is Load, shown in Listing 24-4. 


Listing 24-4. The SerializationManager: :Load Method 


bool SerializationManager: :Load() 
{ 
std::ifstream file{ m filename }; 
bool found = file.is open(); 
if (found) 
{ 
bool isValid; 
file >> isValid; 
if (isValid) 
{ 
std::cout << 
"Save game found, would you like to load? (Type yes to load)" 
<< std::endl << std::endl; 
std::string shouldLoad; 
std::cin >> shouldLoad; 
if (shouldLoad == "yes") 
{ 
while (!file.eof()) 
{ 
unsigned int serializableld{ 0 }; 
file >> serializableld; 
auto iter = m serializables.find(serializableId) ; 
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if (iter != m_serializables.end()) 


{ 
iter->second->OnLoad(file) ; 
} 
} 
} 
} 
else 
{ 
found = false; 
} 


return found; 


} 


The Load method is a little more involved than Save. You can see that it is using an ifstream, input 
file stream, rather than an ofstream. The ifstream is initialized using the file name to load. The 
is_open method in ifstream is used to determine if a file with the given name was found. If the 
player has never played the game, then no save file will exist; this check ensures that we do not try 
to load a game when no save game exists. 


The next check is used to determine if the save file that does exist has a valid save state inside. This 
is done using the >> operator, just as is done when using cin. This is what happens next when cin is 
used to ask the player if he or she would like to load the save game. If the player types anything but 
yes, then game will start without loading. 


There is then a while loop that is checking if the eof method is returning true. The eof method is 
determining whether the method has hit the end of file. The inner section of this loop reads the 
unique ID from the file, retrieves the Serializable from the map, and then calls the OnLoad method 
on that object. 


The last SerializationManager method is ClearSave, which is used to write out a file with false as 
its only value. Listing 24-5 shows this method. 


Listing 24-5. The SerializationManager: :ClearSave Method 


void SerializationManager: :ClearSave() 


{ 
std::ofstream file{ m filename }; 
file << false; 


} 


The SerializationManager class is fairly simple. The Serializable class is also straightforward 
and is listed in Listing 24-6. 


Listing 24-6. The Serializable Class 


class Serializable 


{ 


unsigned int m_id{ 0 }; 
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public: 
explicit Serializable(unsigned int id) 
: m id{ id } 
{ 
SerializationManager: :GetSingleton() .RegisterSerializable(this) ; 
} 
Serializable: :~Serializable() 
{ 
SerializationManager* pSerializationManager = 
SerializationManager: :GetSingletonPtr(); 
if (pSerializationManager) 
{ 
pSerializationManager->RemoveSerializable(this) ; 
} 
} 
virtual void OnSave(std::ofstream& file) = 0; 
virtual void OnLoad(std::ifstream& file) = 0; 


unsigned int GetId() const { return m_id; } 


J 


The Serializable class is intended to be inherited by the classes you would like to be able to save 
between game sessions and is therefore implemented as an interface. This is achieved by making 
the OnSave and OnLoad method purely virtual. 


Each Serializable also stores an ID in the m_id variable. The constructor and destructor 
automatically adds and removes the object from the SerializationManager object that it accesses 
via the Singleton pattern. 


Saving and Loading Text Adventure 


The first step toward being able to save and load the game is to create the SerializationManager. 
Listing 24-7 shows the updated main function. 


Listing 24-7. The Updated main Function 


int _tmain(int argc, _TCHAR* argv[]) 
{ 


new SerializationManager(); 


Game game; 
game.RunGame() ; 


delete SerializationManager: :GetSingletonPtr(); 


return 0; 
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Creating and deleting the SerializationManager in main ensures that it exists for the entirety of the 
Game: :RunGame method. The game is saved when the player chooses to quit, and Listing 24-8 shows 
how this is achieved. 


Listing 24-8. Saving the Game 


void Game: :OnQuit() 
{ 


SerializationManager: :GetSingleton().Save(); 
m_playerQuit = true; 


} 


A call to SerializationManager: : Save is added to the Game: :OnQuit method. The Load and 
ClearSave methods are added to Game: :RunGame in Listing 24-9. 


Listing 24-9. The Game: :RunGame Method 


void Game: :RunGame() 


{ 


InitializeRooms(); 


const bool loaded = SerializationManager: :GetSingleton().Load(); 
WelcomePlayer (loaded) ; 


bool playerWon = false; 
while (m_playerQuit == false && playerWon == false) 


GivePlayerOptions(); 


stringstream playerInputStream; 
GetPlayerInput (playerInputStream) ; 


EvaluateInput (playerInputStream) ; 


for (auto& enemy : m enemies) 


{ 


playerWon = enemy->IsAlive() == false; 


} 
if (playerWon == true) 


SerializationManager: :GetSingleton().ClearSave(); 

cout << "Congratulations, you rid the dungeon of monsters!" << endl; 
cout << "Type goodbye to end" << endl; 

std::string input; 

cin >> input; 


260 CHAPTER 24: Using File 10 to Save and Load Games 


—— OOO 


The WelcomePlayer method is now updated to ask the players if they would like to load their save 
game in Listing 24-10. 


Listing 24-10. Updating Game : :WelcomePlayer 


void Game: :WelcomePlayer(const bool loaded) 


{ 
if (!loaded) 
{ 
cout << "Welcome to Text Adventure!" << endl << endl; 
cout << "What is your name?" << endl << endl; 
string name; 
cin >> name; 
m_player.SetName(name) ; 
cout << endl << "Hello " << m_player.GetName() << endl; 
} 
else 
{ 
cout << endl << "Welcome Back " << m_player.GetName() << endl << endl; 
} 
} 


WelcomePlayer now greets players with a Welcome Back message once the game has loaded and 
reinstated the name they entered when they first played the game. 


The next change to the Game class code is to pass a unique ID into the constructor of each object we 
would like to be a Serializable. The Game constructor is one place where this happens, as shown in 
Listing 24-11. 


Listing 24-11. The Game Class Constructor 


Game: : Game () 
: m_attackDragonOption{ 
CreateOption( 
PlayerOptions: :AttackEnemy, 
SDBMCalculator<18>: :CalculateValue("AttackDragonOption")) } 
» m_attackOrcOption{ 
CreateOption( 
PlayerOptions: :AttackEnemy, 
SDBMCalculator<15>: :CalculateValue("AttackOrcOption")) } 
» m moveNorthOption{ 
CreateOption( 
PlayerOptions: :GoNorth, 
SDBMCalculator<15>: :CalculateValue("MoveNorthOption")) } 
» m _moveEastOption{ 
CreateOption( 
PlayerOptions: :GoEast, 
SDBMCalculator<14>: :CalculateValue("MoveEastOption")) } 
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, m moveSouthOption{ 
CreateOption( 
PlayerOptions: :GoSouth, 
SDBMCalculator<15>: :CalculateValue("MoveSouthOption")) } 
» m moveWestOption{ 
CreateOption( 
PlayerOptions: :GoWest, 
SDBMCalculator<14>: :CalculateValue("MoveWestOption")) } 
» m_openSwordChest{ 
CreateOption( 
PlayerOptions: :OpenChest, 
SDBMCalculator<20>: :CalculateValue("OpenSwordChestOption")) } 
» m quitOption{ 
CreateOption( 
PlayerOptions: :Quit, 
SDBMCalculator<10>: :CalculateValue("QuitOption")) } 
» m _swordChest{ &m sword, SDBMCalculator<5>::CalculateValue("Chest") } 


{ 
static_cast<OpenChestOption*>(m_openSwordChest.get())->SetChest(&m_swordChest) ; 
m_enemies.emplace_back( 
CreateEnemy( 

EnemyType: :Dragon, 

SDBMCalculator<6>: :CalculateValue("Dragon"))); 
static_cast<AttackEnemyOption*>(m_attackDragonOption.get())->SetEnemy(m_enemies[0]); 
m_enemies.emplace_back( 

CreateEnemy( 

EnemyType: :Orc, 

SDBMCalculator<3>::CalculateValue("Orc"))); 
static_cast<AttackEnemyOption*>(m_attackOrcOption.get())->SetEnemy(m_enemies[1]); 
static_cast<QuitOption*>(m_quitOption.get())->AddObserver (this) ; 

} 


As you can see, each factory function now takes a hashed string that is used to construct the object 
and supply a unique ID for the SerializationManager’s unordered_map. This unique key is also useful 
for game objects to be able to save out their references to other objects. You can see this in 

Listing 24-12, in which the source code for Player: :OnSave is shown. 


Listing 24-12. The Player: :OnSave Method 


void Player: :OnSave(std::ofstream& file) 
{ 

file << m_name; 

file << std::endl; 

file << m_items.size(); 

file << std::endl; 
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for (auto& item : m_items) 

{ 
file << item->GetId(); 
file << std::endl; 

} 

file << m_pCurrentRoom->GetId(); 

file << std::endl; 

} 


The Player: :OnSave method writes out the name the user supplied when beginning his or her game. 
It then writes out the number of items in the m_items collection. Each item’s ID is written out and 
finally the m_pCurrentRoom ID is written out. The block of text in the save file for a player looks like 
the following: 


1923481025 
Bruce 

1 
3714624381 
625001751 


The first line is the unique ID of the Player object, followed by the m_name, the number of Items, the 
ID of the one item, and finally the ID of the Room the player was in at the time he or she quit. 


The Player: :OnSave method is mirrored by the Player: :OnLoad method in Listing 24-13. 


Listing 24-13. The Player: :OnLoad Method 


void Player: :OnLoad(std::ifstream& file) 
{ 
file >> m_name; 
unsigned int numItems; 
file >> numItems; 
for (unsigned int i = 0; i < numItems; ++i) 
{ 
unsigned int itemId; 
file >> itemId; 
Item* pItem = 
dynamic_cast<Item*>( 
SerializationManager: :GetSingleton() .GetSerializable(itemId)); 
m_items.emplace back{ pItem }; 


} 


unsigned int roomId; 
file >> roomId; 
Room* pRoom = 
dynamic_cast<Room*> ( 
SerializationManager: :GetSingleton() .GetSerializable(roomId)); 
m_pCurrentRoom = pRoom->GetPointer(); 


CHAPTER 24: Using File 10 to Save and Load Games 263 


The OnLoad method reads the m_name variable out of the file, then the number of items. There is 
then a for loop that reads out the IDs of each item and retrieves a pointer to the Item from the 
SerializationManager. Each Serializable pointer is converted into an Item pointer using a 
dynamic_cast. 


The Room pointer is a little more challenging. The Player class does not store a raw pointer to the 
Room object; instead, a shared_ptr was used. Listing 24-14 shows how the Room class has been 
updated to store a shared_ptr to itself, which can be used to retrieve a valid shared_ptr when 
retrieving the object from the SerializationManager. 


Listing 24-14. The Room Class 


class Room 
: public Entity 
s public Serializable 
{ 
public: 
using Pointer = std::shared_ptr<Room>; 


enum class JoiningDirections 
{ 

North = 0, 

East, 

South, 

West, 

Max 


F; 


private: 
using JoiningRooms = std::array<Pointer, static_cast<size_t>(JoiningDirections: :Max)>; 
JoiningRooms m_pJoiningRooms ; 


using StaticOptions = std::map<unsigned int, Option: :Pointer>; 
StaticOptions m_staticOptions; 
unsigned int m_staticOptionStartKey{ 1 }; 


using DynamicOptions = std::vector<Option: :Pointer>; 
DynamicOptions m_dynamicOptions; 


Pointer m_pointer{ this }; 


public: 
explicit Room(unsigned int serializableId) ; 


void AddRoom(JoiningDirections direction, Pointer room); 
Pointer GetRoom(JoiningDirections direction) const; 


Option: :Pointer EvaluateInput(unsigned int playerInput) ; 
void AddStaticOption(Option: :Pointer option); 

void AddDynamicOption(Option: :Pointer option); 

void PrintOptions() const; 
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virtual void OnSave(std::ofstream& file); 
virtual void OnLoad(std::ifstream& file); 


Pointer GetPointer() const { return m_pointer; } 


}3 


Now any time any part of our code wishes to store a shared_ptr to a Serializable object, it should 
be retrieving the pointer from a shared place. The easiest place for this to be is on the object itself, 
which is registered with the SerializationManager via its unique ID. 


The Room class has to save and load the state of its dynamic options. Listing 24-15 shows the save 
and load methods. 


Listing 24-15. Room: :OnSave and Room: : OnLoad 


void Room: :OnSave(std::ofstream& file) 


{ 
file << m_dynamicOptions.size(); 
file << std::endl; 
for (auto& dynamicOption : m_dynamicOptions) 
file << dynamicOption->GetId(); 
file << std::endl; 
} 
} 
void Room: :OnLoad(std::ifstream& file) 
{ 


m_dynamicOptions.clear(); 


unsigned int numDynamicOptions; 
file >> numDynamicOptions; 

if (numDynamicOptions > 0) 

{ 


for (unsigned int i = 0; i < numDynamicOptions; ++i) 


unsigned int optionId; 
file >> optionId; 
Option* pOption = 
dynamic_cast<Option*>( 
SerializationManager: :GetSingleton() .GetSerializable(optionId) ); 
if (pOption) 
{ 


Option: :Pointer sharedPointer = pOption->GetPointer(); 
m_dynamicOptions.emplace back{ sharedPointer }; 
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The OnSave method loops over all of the dynamic options and saves their unique IDs after saving 
the number of dynamic options the state has. The OnLoad method begins by clearing the existing 
dynamic options and then reinstates each option from the SerializationManager. Once again this is 
done using a dynamic_cast and retrieving a shared_ptr from the Option class instances. 


The Chest class and the Enemy classes are the only other classes with added OnSave and OnLoad 
methods. These are used to save the m_isOpen and m_alive variables from these classes and are 
shown in Listing 24-16. 


Listing 24-16. The Chest: :OnSave, Chest: : OnLoad, Enemy: :OnSave, and Enemy: : OnLoad Methods 
virtual void Chest: :OnSave(std::ofstream& file) 


{ 
file << m_isOpen; 
} 
virtual void Chest: :OnLoad(std::ifstream& file) 
{ 
file >> m_isOpen; 
} 
virtual void Enemy: :OnSave(std::ofstream& file) 
{ 
file << m_alive; 
} 
virtual void Enemy: :OnLoad(std::ifstream& file) 
{ 
file >> m_alive; 


These simple methods round out the last of the class changes to support the saving and loading 
of the Text Adventure game. At this point l’d encourage you to get the sample code from the 
accompanying web site and take a look at the execution of the program in your debugger to get a 
feeling for how the ability to be able to reference objects via a centralized system using unique IDs 
can be very useful. 


Summary 


This chapter has given you an overview of a simple mechanism for implementing the ability to save 
and load your games. The ifstream and ofstream classes provide a simple mechanism for writing 
and reading file data for your programs. These classes follow the usual conventions for stream types 
in C++ and should be easily recognizable from the cin, cout, and stringstream examples you have 
already seen throughout this book. 


One of the most important lessons to take away from this chapter is the fact that pointers are not 
transferrable from one game session to the next. This is true for trying to implement a loading and 
saving system and is also true for implementing a multiplayer game. Pointer addresses cannot be sent 
from one computer to another to refer to any given object. Instead objects need to be created with a 
consistent and persistent unique ID and registered with a centralized system, which ensures there are 
no key clashes and can provide access to objects wherever it might be needed in your code. 


__ 


Chapter 


Speeding Up Games with 
Concurrent Programming 


Processor manufacturers have hit a ceiling on the number of cycles their CPUs can execute per 
second. This can be seen with modern CPUs in desktop computers, tablets, and mobile phones 
where CPU speeds are rarely seen over the 2.5 Ghz mark. 


CPU manufacturers have taken to adding more and more cores to their CPUs to provide more and 
more performance. The Xbox One, PlayStation 4, Samsung Galaxy phones, and desktop CPUs all 
have access to eight CPU cores to execute programs. This means that programmers of modern 
software need to embrace multithreaded, concurrent programming if they wish their programs to 
get the most out of modern computing devices and feel fluid and responsive for their users. Game 
programmers have to think about concurrency even across different processors. The Xbox One and 
PlayStation 4 actually have dual quad-core CPUs, audio CPUs, and GPUs all executing code at the 
same time. 


This chapter will introduce multicore CPU programming so that you can have a basic understanding 
of how C++ allows you to execute code on multiple threads, how to ensure that those threads 
share resources responsibly, and how to make sure that all of the threads are destroyed before your 
program ends. 


Running Text Adventure in Its Own Thread 


I’m going to show you how to create a thread in this section that will execute the Game: : RunGame 
method. This will mean that the main game loop is running in its own execution thread and our main 
function is left to carry out other tasks. Listing 25-1 shows how to create a game thread. 
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Listing 25-1. Creating a Thread 


#include "GameLoop.h" 
#include <thread> 


void RunGameThread(Game& game) 


{ 
game.RunGame() ; 
} 
int _tmain(int argc, _TCHAR* argv[]) 
{ 
new SerializationManager(); 
Game game; 
std::thread gameThread{ RunGameThread, std::ref{ game } }; 
assert (gameThread. joinable()); 
gameThread. join(); 
delete SerializationManager: :GetSingletonPtr(); 
return 0; 
} 


C++ provides the thread class that will automatically create a native operating system thread and 
execute a function that you pass into its constructor. In this example, we are creating a thread 
named gameThread that will run the RunGameThread function. 


RunGameThread takes a reference to a Game object as a parameter. You can see that we are using 
std: :ref to pass the game object to gameThread. You need to do this because the thread class 
constructor makes a copy of the object being passed in. Once it has this copy and starts the 
thread, the destructor is called on the copy. Calling ~Game will call “Player, which will unregister 
our m_player object from the SerializationManager. If this happens, our game will crash, as the 
m_player object will not exist whenever the game tries to load the user’s save game. The std: : ref 
object avoids this by storing a reference to the game object internally and making copies of itself. 
When the destructors are being called, they are called on the ref object and not on the object 
passed. This prevents the crash you would otherwise experience. 


Execution continues on your original thread once the new thread has been created and is running 

the function you supplied. At this point you can carry out some other tasks. Text Adventure doesn’t 
have any other jobs to complete at the moment, and therefore execution would carry on, delete the 
SerializationManager, and return. This would cause another crash because your gameThread would 
go out of scope and try to destroy your running thread. What you really want to happen is for _tmain to 
stop executing until the task being carried out in gameThread has completed. Threads complete when 
their function returns and in our case we will be waiting for the player to either quit or win the game. 


You make a running thread wait for another by calling join on the other thread’s object. The 
joinable method is supplied to make sure that the thread you would like to wait on is one that is 
valid and running. You can test this by placing a breakpoint on the delete SerializationManager 
line. Your breakpoint will not be hit until you complete your game. 
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That’s all there is to creating, running, and waiting for threads in C++. The next task is to work out 
how to make sure that threads can share data between each other without causing issues. 


Sharing Data Between Threads Using Mutexes 


Multithreaded programming introduces problems. What happens if two threads try to access the 
same variables at exactly the same time? Data can be inconsistent, data can be wrong, and changes 
can be lost. In the very worst examples your programs will crash. The updated main function in 
Listing 25-2 shows an example of a program that would crash when both threads access the same 
functions at the same time. 


Listing 25-2. A Version of _tmain That Would Crash 


int _tmain(int argc, _TCHAR* argv[]) 
{ 


new SerializationManager(); 


Game game; 

std::thread gameThread{ RunGameThread, std::ref{ game } }; 
assert (gameThread. joinable()); 

while (!game.HasFinished()) 


// Stick a breakpoint below to see that this code 
// is running at the same time as RunGame! 
int x = 0; 


gameThread. join(); 
delete SerializationManager: :GetSingletonPtr(); 


return 0; 


} 


This code would crash because the Game: :HasFinished method is being called repeatedly. It is 
guaranteed that both the main thread and the game thread would try to access the variables inside 
HasFinished at the same time. Listing 25-3 contains the Game: :HasFinished method. 


Listing 25-3. Game: : HasFinished 


bool HasFinished() const 


return (m playerQuit || m_playerWon); 


} 


The Game class tries to write to the m_playerWon variable once every loop. Eventually the main thread 
will try to read the m_playerWon variable at the same time as the game thread is writing to it and the 
program will close. You solve this problem by using mutual exclusion. C++ provides a mutex class 
that blocks execution on multiple threads around accesses to shared variables. By adding the code 
from Listing 25-4 you can create a mutex in the Game class. 
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Listing 25-4. Creating amutex 


std: :mutex m_mutex; 
std: :unique_lock<std::mutex> m_finishedQueryLock{ m mutex, std::defer_lock }; 


We have two parts to our mutex, the mutex itself and a wrapper template named unique_lock, which 
provides convenient access to the behavior of the mutex. The unique_lock constructor takes a mutex 
object as its main parameter. This is the mutex that it acts on. The second parameter is optional; 

if it is not supplied, the unique_lock obtains a lock on the mutex immediately but by passing 

std: :defer_lock we can prevent this from happening. 


At this point you might be wondering exactly how a mutex works. A mutex can be locked and 
unlocked. We class the process of locking a mutex as obtaining a lock. The unique_lock template 
provides three methods to work with the mutex: lock, unlock, and try_lock. 


The lock method is a blocking call. This means that your thread’s execution will stall until the mutex 
has been successfully locked by the thread you called lock from. If the mutex is already locked by 
another thread, your thread will wait until the mutex becomes unlocked before proceeding. 


The unlock method unlocks a locked mutex. Best practice is to hold your lock for as few lines 

of code as possible. Generally this means that you should do any calculations you need before 
obtaining a lock, obtain the lock, write the result to the shared variable, and then unlock immediately 
to allow other threads to lock the mutex. 


The try_lock method is a nonblocking version of lock. This method returns true if the lock was 
obtained or false if the lock was not obtained. This allows you to do other work, usually in a loop 
within the thread until such time that the try_lock method returns true. 


Now that you have seen the code to create a lock, | can show you how to use the unique_lock 
template to prevent your Text Adventure game from crashing. Listing 25-5 uses the lock to protect 
access to the m_playerQuit and m_playerWon variables in the HasFinished method. 


Listing 25-5. Updating Game: :HasFinished with the unique_lock 


bool HasFinished() const 


{ 
m_finishedQueryLock.lock(); 
bool hasFinished = m playerQuit || m_playerWon; 
m_finishedQueryLock.unlock(); 
return hasFinished; 
} 


The HasFinished method now calls the Lock method on m_finishedQueryLock before it calculates 
the value to be stored in the hasFinished variable. The lock is released before the return statement in 
the method to allow any waiting threads to be able to lock the mutex. 


This is only the first step in being able to protect our program from crashes. The HasFinished 
method is called on the main thread but the m_playerWon and m_playerQuit variables are written 
to from the game thread. | have added three new methods to protect these variables in the game 
thread in Listing 25-6. 
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Listing 25-6. The Game: : SetPlayerQuit and Game: :SetPlayerWon Methods 
void SetPlayerQuit() 


{ 
m_finishedQueryLock.lock(); 
m_playerQuit = true; 
m_finishedQueryLock.unlock(); 

} 

void SetPlayerWon() 

{ 
m_finishedQueryLock.lock(); 
m_playerWon = true; 
m_finishedQueryLock.unlock(); 

} 

bool GetPlayerWon() 

{ 
m_finishedQueryLock.lock(); 
bool playerWon = m_playerWon; 
m_finishedQueryLock.unlock(); 
return playerWon; 

} 


This means that we are required to update the Game: :OnQuit method as shown in Listing 25-7. 


Listing 25-7. The Game: :OnQuit Method 


void Game: :OnQuit() 
{ 


SerializationManager: :GetSingleton() .Save(); 
SetPlayerQuit(); 
} 


The Game: :OnQuit method now calls the SetPlayerQuit method, which uses the m_finishedQueryLock 
to protect the variable access. The RunGame method needs to be updated to use the SetPlayerWon 
and GetPlayerWon methods and is shown in Listing 25-8. 


Listing 25-8. Updating Game : :RunGame 


void Game: :RunGame() 


{ 


InitializeRooms(); 


const bool loaded = SerializationManager: :GetSingleton().Load(); 
WelcomePlayer(loaded) ; 


while (!HasFinished() ) 


{ 
GivePlayerOptions(); 
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stringstream playerInputStream; 
GetPlayerInput (playerInputStream) ; 


EvaluateInput (playerInputStream) ; 


bool playerWon = true; 
for (auto& enemy : m_enemies) 


{ 


playerlion &= enemy->IsAlive() == false; 


if (playerWon) 
SetPlayerWon(); 


} 
if (GetPlayerWon()) 
{ 


SerializationManager: :GetSingleton() .ClearSave() ; 

cout << "Congratulations, you rid the dungeon of monsters!" << endl; 
cout << "Type goodbye to end" << endl; 

std::string input; 

cin >>input; 


} 


The bold lines show the updates to this method to support the mutex protection around our shared 
variables. There’s an attempt to follow best practice by using a local variable to work out if the player 
has won the game before calling the SetPlayerWon method. You could wrap the entire loop in a mutex 
lock mechanism, but this would slow your program, as both threads would be spending longer in a 
state where they were simply waiting for locks to be unlocked and not executing code. 


This extra work is one reason why splitting a program into two separate threads does not give a 
100% increase in performance as there is some overhead to waiting for lock to synchronize access 
to shared memory between the threads. Reducing these synchronization points is key to extracting 
as much performance as possible from multithreaded code. 


Threads and mutexes make up a low-level view of multithreaded programming. They represent 
abstract versions of operating system threads and locks. C++ also provides higher level threading 
abstractions that you should use more often than threads. These are provided in the promise and 
future classes. 


Using Futures and Promises 


The future and promise classes are used in a pair. The promise executes a task and places its result 
in a future. A future blocks execution on a thread until the promise result is available. Fortunately 
C++ provides a third template to create a promise and future for us so that we don’t have to 
manually do this over and over. 
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Listing 25-9 updates the Game: :RunGame to use a packaged_task to load the user’s save game data. 


Listing 25-9. Using a packaged_task 


bool LoadSaveGame() 


{ 
return SerializationManager: :GetSingleton().Load(); 
} 
void Game: :RunGame() 
{ 


InitializeRooms(); 


std: :packaged_task< bool() > loaderTask{ LoadSaveGame }; 

std::thread loaderThread{ std::ref{ loaderTask } }; 

auto loaderFuture = loaderTask.get_future(); 

while (loaderFuture.wait_for(std::chrono::seconds{ 0 }) != std::future_status: :ready) 


{ 
// Wait until the future is ready. 
// In a full game you could update a spinning progress icon! 
int x = 0; 

} 


bool userSaveLoaded = loaderFuture.get(); 
WelcomePlayer(userSaveLoaded) ; 


while (!HasFinished() ) 
{ 
GivePlayerOptions(); 


stringstream playerInputStream; 
GetPlayerInput (playerInputStream) ; 


EvaluateInput (playerInputStream) ; 


bool playerWon = true; 
for (auto& enemy : m enemies) 


{ 
} 


playerWon &= enemy->IsAlive() == false; 


if (playerWon) 
{ 


SetPlayerWon() ; 
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if (GetPlayerWon()) 


SerializationManager: :GetSingleton() .ClearSave(); 

cout << "Congratulations, you rid the dungeon of monsters!" << endl; 
cout << "Type goodbye to end" << endl; 

std::string input; 

cin >>input; 


} 


The first step was to create a function, LoadSaveGame, to be executed in another thread. 
LoadSaveGame calls the SerializationManager: :Load method. The LoadSaveGame function pointer is 
passed into the packaged_task constructor. The packaged_task template has been specialized with 
the type bool(). This is the type of the function; it returns a bool and does not take any parameters. 


Then std: :ref is used to pass the packaged_task into a thread. When a packaged_task is passed to 
a thread it can be executed, as a thread object knows how to handle packaged_task objects. This 
is true because a packaged_task object overloads an operator, which allows it to be called just like 
a function. This overloaded function call operator calls the actual function used to construct the 
packaged_task. 


The main thread can now call the get_future method on the packaged_task. A future is used in 
threaded programs to allow you to set up tasks that will provide returned values at some point in 
the future. You could call get immediately on the future, but as get is a blocking call, your thread 
would stall until the future result is available. Listing 25-9 shows an alternate implementation where 
wait_for is used to check if the future result is available. 


The future: :wait_for method takes a value from the std: : chrono set of duration classes. In this 
case, we are passing in std: :chrono::seconds{ 0 }, which means the method will return instantly 
with a result. The possible return values in our case come from the std::future_status enum class 
and are ready or timeout. The timeout value will be returned until the player’s game is loaded or he 
or she chooses to start a new game. At that point we can call the future: : get method, which stores 
the value returned from SerializationManager: : Load, via the LoadSaveGame function passed to 
loaderTask. 


That wraps up your brief introduction to multithreaded C++ programming. 


Summary 


In this chapter you have been introduced to some of the classes C++ provides to allow you to add 
multiple execution threads to your programs. You first saw how threads can be created to execute 
functions. Calling functions in this manner allows the operating system to run your threads on more 
than one CPU thread and speed up the execution of your program. 


When you use threads you need to make sure that your threads do not conflict when accessing 
variables and sharing data. You saw that the mutex can be used to manually provide mutually exclusive 
access to variables. After showing a mutex in action, | then introduced you to the packaged_task 
template, which automatically creates a promise and a future to better manage your concurrent 
tasks at a higher level than the base thread and mutex. 
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Using threads like this can allow you to provide better responsiveness to players. They aren’t 
particularly effective in this task in a text-based game, but they can be used to provide more CPU 
execution time per frame in a 3D graphics-based game or for situations such as having a constantly 
updating loading or progress bar when long-running tasks are executing on other CPUs. Better 
responsiveness or faster frame rates improve usability and players’ perception of your games. 


The next and last chapter in this book will show you techniques that you can use to write code that 
will compile on multiple platforms. This will be useful if you find yourself in a situation where you 
want to write games that can run on iOS, Android and Windows Phones, or Windows and Linux, or 
even consoles such as the Xbox One and PlayStation 4. You might even write a game that can run 
on all of these in the same way an engine such as Unity can. 
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Chapter 


Supporting Multiple Platforms 
in C++ 


There will come a time in your game development career when you have to write code that will only 
work on a single platform. That code will have to be compiled out of other platforms. You will more 
than likely also have to find alternative implementations for each of the platforms you will be working 
on. Classic examples of such code can usually be found in interactions between your game and 
online login and microtransaction solutions such as Game Center, Google+, Xbox Live, PlayStation 
Network, and Steam. 


There can be more complicated problems between different platforms. iOS devices run on Arm 
processors; Android supports Arm, x86, and MIPS; and most other operating systems can be run 

on more than a single instruction set. The problem that can arise is that compilers for each of these 
CPU instruction sets can use different sizes for their built-in types. This is especially true when 
moving from 32-bit CPUs to 64-bit CPUs. In these situations pointers are no longer 32 bits in size; 
they are, in fact, 64 bits. This can cause all sorts of portability problems if you assume that types and 
pointers are of a fixed size. These issues can be very difficult to track down and will usually cause 
either graphical corruption or you will see your programs simply crash at random times. 


Ensuring Types Are the Same Size on Multiple Platforms 


Ensuring that your program uses the same size of types in your programs on multiple platforms will 
be easier than you might initially think. The C++ STL provides a header called cstdint that contains 
types that are of a consistent size. These types are: 


int8_t and uint8 t 

int16 t and uint16 t 
int32_t and uint32_t 
int64 t and uint64 t 
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The int8 t and uint8 t provide integers that are 8 bits or one byte in length. The u version is 
unsigned and the non-u version is signed. The other types are similar but of their equivalent fixed 
length. There are 16-bit versions, 32-bit versions, and 64-bit versions of integers. 


Note You should avoid using the 64-bit integers for the time being unless you explicitly need numbers that 
cannot be stored within 32 bits. Most processors still operator on 32-bit integers when doing arithmetic. Even 
64-bit processors that have 64-bit memory addresses for pointers still do normal arithmetic using 32-bit ints. 
In addition, 64-bit values use twice as much memory as 32-bit values, which increases the RAM required to 
execute your program. 


The next problem that might arise is that the char type might not be the same on all platforms. 
C++ does not supply a fixed-size char type, so we need to improvise a little. Every platform | have 
developed games on has used 8-bit char types, so we’re only going to account for that. We will, 
however, define our own char type alias so that if you ever do port code to a platform with chars 
larger than 8 bits then you will only have to solve the problem in a single place. Listing 26-1 shows 
the code for a new header, FixedTypes.h. 


Listing 26-1. FixedTypes.h 


#pragma once 

#include <cassert> 
#include <cstdint> 
#include <climits> 


static_assert(CHAR BIT == 8, "Compiling on a platform with large char type!"); 
using char8_t = char; 
using uchar8 t = unsigned char; 


The FixedTypes.h file includes cstdint, which gives us access to the 8- to 64-bit fixed-width 
integers. We then have a static_assert that ensures that the CHAR_BIT constant is equal to 8. 

The CHAR_BIT constant is supplied by the climits header and contains the number of bits that are 
used by the char type on your target platform. This static_assert will ensure that our code, which 
includes the FixedTypes header, will not compile on platforms that use a char with more than 8 
bits. The header then defines two type aliases, char8_t and uchar8_t, which you should use when 
you know you specifically need 8-bit chars. This isn’t necessarily everywhere. Generally you will 
need 8-bit char types when loading data that was written out using tools on another computer that 
did use 8-bit character values because the length of the strings in the data will have one byte per 
character rather than more. If you’re not sure if you do or don’t need 8 bits specifically, you’re better 
sticking to always using 8-bit chars. 


The last problem solved in the cstdint header is for using pointers on platforms with different-sized 
pointers to integers. Consider the code in Listing 26-2. 
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Listing 26-2. An Example Bad Pointer Cast 


bool CompareAddresses(void* pAddress1, void* pAddress2) 


{ 
uint32_t addressi = reinterpret_cast<uint32_t>(pAddress1) ; 
uint32_t address2 = reinterpret_cast<uint32_t>(pAddress2) ; 
return addressi == address2; 

} 


There are a handful of cases where you might be required to compare the values of two addresses 
and you could case the pointers to 32-bit unsigned ints to achieve this comparison. This code, 
however, is not portable. The following two hexadecimal values represent different memory locations 
on 64-bit computers: 


OxFFFFFFFFOO000000 
0x0000000000000000 


If you cast these two values to uint32_t the two hex values stored in the unsigned integers will be: 


0x00000000 
0x00000000 


The CompareAddresses function would return true for two different addresses because the upper 32 
bits of the 64-bit addresses have been narrowed without warning by reinterpret_cast. This function 
would always work on systems with 32-bit pointers or less and only break on 64-bit systems. 

Listing 26-3 contains the solution to this problem. 


Listing 26-3. An Example of a Good Pointer Comparison 


bool CompareAddresses(void* pAddressi, void* pAddress2) 


{ 
uintptr_t address1 = reinterpret_cast<uintptr_t>(pAddress1) ; 
uintptr_t address2 = reinterpret_cast<uintptr_t>(pAddress2) ; 
return addressi == address2; 

} 


The cstdint header provides intptr_t and uintptr_t, which are signed and unsigned integers with 
enough bytes to completely store an address on your target platform. You should always use these 
types when casting pointers into integer values if you would like to write portable code! 


Now that we’ve covered the different issues we can encounter with different-sized integers and 
pointers on different platforms, we’ll look at how we can provide different implementations of classes 
on different platforms. 


Using the Preprocessor to Determine Target Platform 


Straight off the bat in this section, I’ll show you a header file that defines preprocessor macros 
to determine which platform you are currently targeting. Listing 26-4 contains the code for the 
Platforms .h header file. 
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mo armasman O 


Listing 26-4. Platforms .h 


#pragma once 
#if defined(_WIN32) || defined(_WIN64) 


#define PLATFORM_WINDOWS 1 
#define PLATFORM ANDROID O 
#define PLATFORM_IOS O 


#elif defined(_ ANDROID_) 


#define PLATFORM WINDOWS O 
#define PLATFORM ANDROID 1 
#define PLATFORM I0S O 


#elif defined(TARGET_OS IPHONE) 


#define PLATFORM WINDOWS O 
#define PLATFORM ANDROID O 
#define PLATFORM IOS 1 


#endif 


This header achieves the task of converting preprocessor symbols provided by the Windows, 
Android, and iOS build tools into single definitions that we can now use in our own code. The 
_WIN32 and _WIN64 macros are added to your build on Windows machines, whereas __ANDROID __ 
and TARGET_OS_IPHONE exist when building Android and iOS applications. These definitions can 
change over time, and an obvious example is the _WIN64 macro, which did not exist before the 64- 
bit versions of the Windows operating system and this is the reason for wanting to create our own 
platform macros. We can add or remove from Platforms .h as we see fit without affecting the rest of 
our program. 


I’ve updated the Enemy classes to have platform-specific implementations to show you how you can 
put these platform-specific classes into action. Listing 26-5 shows that the Enemy class has been 
renamed EnemyBase. 


Listing 26-5. Renaming Enemy to EnemyBase 


#pragma once 


#include "Entity.h" 
#include "EnemyFactory.h" 
#include "Serializable.h" 
#include <memory> 


class EnemyBase 
: public Entity 
» public Serializable 
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{ 
public: 


private: 


public: 


J 


using Pointer = std::shared_ptr<EnemyBase> ; 


EnemyType m_type; 
bool m alive{ true }; 


EnemyBase(EnemyType type, const uint32_t serializableld) 
: m_type{ type } 
» Serializable(serializableId) 

{ 

} 

EnemyType GetType() const 


return m_type; 


} 
bool IsAlive() const 
{ 
return m_alive; 
} 
void Kill() 
{ 
m_alive = false; 
} 
virtual void OnSave(std::ofstream& file) 
{ 
file << m_alive; 
} 
virtual void OnLoad(std::ifstream& file) 
{ 
file >>m_alive; 
} 


The class isn’t pure virtual as we don’t actually have any platform-specific code to add as this is an 
exercise for illustrative purposes. You can imagine that a proper base class for platform abstraction 
would have pure virtual methods that would have platform-specific code added. 


The next step is to create three classes for our different platforms. These are shown in Listing 26-6. 
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Listing 26-6. WindowsEnemy, AndroidEnemy, and i0SEnemy 


class WindowsEnemy 
: public EnemyBase 


{ 
public: 
WindowsEnemy(EnemyType type, const uint32_t serializableId) 
: EnemyBase(type, serializableId) 
{ 
std::cout << "Created Windows Enemy!" << std::endl; 
} 
}; 


class AndroidEnemy 
: public EnemyBase 


{ 
public: 
AndroidEnemy(EnemyType type, const uint32_t serializableId) 
: EnemyBase( type , serializableld ) 
{ 
std::cout << "Created Android Enemy!" << std::endl; 
} 
}; 


class i0SEnemy 
: public EnemyBase 


{ 
public: 
i0SEnemy(EnemyType type, const uint32_t serializableId) 
: EnemyBase(type, serializableId) 
{ 
std::cout << "Created iOS Enemy!" << std::endl; 
} 
}; 


These three classes rely on polymorphism to allow the rest of the program to work with the 
EnemyBase class rather than the platform-specific implementations. The last problem to solve is how 
to create these classes. Fortunately the Factory pattern gives us a ready-made solution. Listing 26-7 
updates EnemyFactory to create the correct type of EnemyBase for our implementation. 


Listing 26-7. Updating EnemyFactory with Platform-Specific Types 


namespace 
{ 
#if PLATFORM_WINDOWS 
#include "WindowsEnemy. h" 

using Enemy = WindowsEnemy; 
#elif PLATFORM ANDROID 
#include "AndroidEnemy.h" 

using Enemy = AndroidEnemy; 
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#elif PLATFORM I0S 
#include "i0SEnemy.h" 
using Enemy = i0SEnemy; 
#endif 
} 


EnemyBase* CreateEnemy(EnemyType enemyType, const uint32_t serializableId) 
{ 
Enemy* pEnemy = nullptr; 
switch (enemyType) 
{ 
case EnemyType: :Dragon: 
pEnemy = new Enemy(EnemyType: :Dragon, serializableId) ; 
break; 
case EnemyType: :Orc: 
pEnemy = new Enemy(EnemyType: :Orc, serializableId) ; 
break; 
default: 
assert(false); // Unknown enemy type 
break; 


} 


return pEnemy; 


} 


The CreateEnemy function itself has only changed in one way. Its return type is now EnemyBase rather 
than Enemy. This is the case because I’ve used a type alias to have the Enemy keyword map to the 
correct platform-specific Enemy version. You can see this in action in the unnamed namespace before 
the function. | check each platform definition, include the appropriate header, and finally add using 
Enemy = to set the type alias to the correct type. 


The Factory pattern is the perfect method to use when you need to implement platform-specific 
versions of classes. The Factory allows you to hide the implementation details of the creation of 
objects from the rest of your program. This leads to code that is easier to maintain and reduces the 
number of places in your codebase where you have to change things around to add new platforms. 
Reducing the time to port to a new platform could be a lucrative business opportunity and open up 
new potential revenue streams for your company. 


Summary 


This brings us to the end of your introduction to game programming in C++. This book has walked 
you through the main programming paradigms in C++ from procedural programming to object- 
oriented programming through to generic programming. You’ve also seen how the STL can provide 
you with ready-made data structures as well as algorithms to work on and with those structures. 


The last part of this book has introduced you to some topics that will be important for you to 
learn as you go through your game development career. Mastering managing memory, concurrent 
programming, and higher level topics such as design patterns will ensure that you and your 
programs can adapt to whatever the future brings. 


Chapter 


Wrapping Up 


The C++ programming language is a tool that will serve you well while trying to build video games. 
It provides low-level access to processors, which allows you to write efficient code for a wide variety 
of computer processors. 


This book has shown you various techniques, features, and paradigms that you can apply to 
your own programming efforts. You’ve seen that C++ can be used to write procedural programs 
or object-oriented programs. Procedural programs can be created consisting only of functions, 
variables, and structs, whereas object-oriented programs are built from classes. 


C++ extends these two paradigms by also allowing for generic programming. This type of 
programming is supported through the ability to create templates. Templates are used to create 
blueprints for classes with abstract types. The template compiler is responsible for creating 
specialized instances of template classes at compile time. C++ uses templates to provide the 
Standard Template Library. The STL supplies many data structures and algorithms so that you do 
not have to write every program from scratch. 


An Overview of Text Adventure 


This book ended with a very simple text adventure game that you can now expand into a full game 
if you wish. Listing 27-1 shows the Game class definition. This class encapsulates all of the types of 
programming C++ provides. 


Listing 27-1. The Game Class Definition 


class Game 
: public EventHandler 
» public QuitObserver 
{ 
private: 
static const uint32_t m_numberOfRooms = 4; 
using Rooms = std::array<Room::Pointer, m_numberOfRooms> ; 
Rooms m_rooms; 
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= Sumer 


Player m_player; 


Option: :Pointer m_attackDragonOption; 
Option: :Pointer m_attackOrcOption; 
Option: :Pointer m_moveNorthOption; 
Option: :Pointer m_moveEastOption; 
Option: :Pointer m_moveSouthOption; 
Option: :Pointer m_moveWestOption; 
Option: :Pointer m_openSwordChest; 
Option: :Pointer m_quitOption; 


Sword m_sword; 
Chest m_swordChest; 


using Enemies = std::vector<EnemyBase: :Pointer>; 
Enemies m_enemies; 


std: :mutex m_mutex; 

mutable std::unique_lock<std::mutex> m_finishedQueryLock{ m mutex, std::defer_ lock }; 
bool m playerQuit{ false }; 

void SetPlayerQuit() 


{ 
m_finishedQueryLock.lock(); 
m_playerQuit = true; 
m_finishedQueryLock.unlock(); 
} 


bool m playerWon{ false }; 
void SetPlayerWon() 


{ 
m_finishedQueryLock.lock(); 
m_playerWon = true; 
m_finishedQueryLock.unlock(); 

} 

bool GetPlayerWon() 

{ 
m_finishedQueryLock.lock(); 
bool playerWon = m_playerWon; 
m_finishedQueryLock.unlock(); 
return playerWon; 

} 


void InitializeRooms(); 

void WelcomePlayer(const bool loaded); 

void GivePlayerOptions() const; 

void GetPlayerInput(std::stringstream& playerInput) const; 

void EvaluateInput(std::stringstream& playerInput) ; 
public: 

Game () ; 

virtual ~Game(); 
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void RunGame() ; 
virtual void HandleEvent(const Event* pEvent); 


// From QuitObserver 
virtual void OnQuit(); 


bool HasFinished() const 


{ 
m_finishedQueryLock.lock(); 
bool hasFinished = m playerQuit || m_playerWon; 
m_finishedQueryLock.unlock(); 
return hasFinished; 
} 


}5 


The Game class shows how you can construct classes in C++. There is a parent class from which Game 
derives. This class provides an interface that includes virtual methods. The Game class overrides these 
virtual methods with specific instances of its own. A perfect example of this is the HandleEvent method. 


Game also shows how you can customize STL templates for your own uses. There is an array of 

Room: : Pointer instances as well as a vector of EnemyBase: : Pointer instances. These types of 
pointers are created using type aliases. Type aliases in C++ allow you to create your own named 
types and are generally a good idea. If you ever need to change the type of an object at a later date 
you can get away with just changing the type alias. If you hadn’t used an alias you would be required 
to manually change every location where the type had been used. 


There is also a mutex present in the Game class. This mutex is a clue to the fact that C++ allows you 
to write programs that can execute on multiple CPU cores at once. A mutex is a mutual exclusion 
object that allows you to ensure that only a single thread is accessing a single variable at one time. 


Listing 27-2 contains the final source code for the Game: :RunGame method. This method consists of 
code that shows how you can iterate over collections and use futures. 


Listing 27-2. The Game: :RunGame Method 


void Game: :RunGame() 


{ 


InitializeRooms(); 


std: :packaged task< bool() > loaderTask{ LoadSaveGame }; 
std::thread loaderThread{ std::ref{ loaderTask } }; 
auto loaderFuture = loaderTask.get_future(); 
while (loaderFuture.wait_for(std::chrono::seconds{ 0 }) != std::future status: : ready) 
{ 
// Wait until the future is ready. 
// In a full game you could update a spinning progress icon! 
int32_t x = 0; 
} 
bool userSaveLoaded = loaderFuture.get(); 
WelcomePlayer(userSaveLoaded) ; 
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while (!HasFinished()) 


{ 
GivePlayerOptions(); 


stringstream playerInputStream; 
GetPlayerInput (playerInputStream) ; 


EvaluateInput (playerInputStream) ; 


bool playerWon = true; 
for (auto& enemy : m enemies) 


{ 
playerWon &= enemy->IsAlive() == false; 


if (playerWon) 
{ 
SetPlayerWon() ; 


} 
if (GetPlayerWon()) 


SerializationManager: :GetSingleton().ClearSave(); 

cout << "Congratulations, you rid the dungeon of monsters!" << endl; 
cout << "Type goodbye to end" << endl; 

std::string input; 

cin >>input; 


} 


The range-based for loop can be used in conjunction with the auto keyword to provide easy, 
portable iteration over many STL collections. You can see it in action in RunGame where there is a loop 
over the m_enemies vector. 


A paired_task is used to execute save game loading on a separate thread of execution. The 

std: :thread: :get_future method is used to acquire a future object that lets you know when the 
task you were executing has been completed. This approach to loading can be used to allow you to 
load games while updating a dynamic loading screen. 


There is also an example of how to use cin and cout to read player input and write out messages to 
the console. Input and output are fundamental concepts for game developers as they are essential 
to providing the interactivity that players expect from games. 
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Summary 


Game development is a fun but demanding field to enter. There are many areas to explore, learn, and 
attempt to master. Very few people become proficient in all areas of game development, but their 
programming skills are usually transferable. Programmers can specialize in graphics programming, 
network programming, gameplay programming, or other fields such as audio and animation. 

There will never be a shortage of tasks for programmers to undertake as most large games 

are written in C++ with code bases that have been around for 10 to 20 years. Engines such as 
Cryengine, Unreal, and Unity are written in C++ and provide support for scripting languages 

to create game logic. C++ is a perfect choice for someone looking to begin a career in game 
development that will take them into an AAA game development studio at some point. 


| hope you’ve found this book an enjoyable entry into your journey down the path of your chosen career. 
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